ResourceManagerClient

class oci.resource_manager.ResourceManagerClient(config, **kwargs)

API for the Resource Manager service. Use this API to install, configure, and manage resources via the “infrastructure-as-code” model. For more information, see [Overview of Resource Manager](/iaas/Content/ResourceManager/Concepts/resourcemanager.htm).

Methods

__init__(config, **kwargs) Creates a new service client
cancel_job(job_id, **kwargs) Indicates the intention to cancel the specified job.
change_stack_compartment(stack_id, …) Moves a Stack and it’s associated Jobs into a different compartment.
create_job(create_job_details, **kwargs) Creates a job.
create_stack(create_stack_details, **kwargs) Creates a stack in the specified compartment.
delete_stack(stack_id, **kwargs) Deletes the specified stack object.
detect_stack_drift(stack_id, **kwargs) Checks drift status for the specified stack.
get_job(job_id, **kwargs) Returns the specified job along with the job details.
get_job_logs(job_id, **kwargs) Returns log entries for the specified job in JSON format.
get_job_logs_content(job_id, **kwargs) Returns raw log file for the specified job in text format.
get_job_tf_config(job_id, **kwargs) Returns the Terraform configuration file for the specified job in .zip format.
get_job_tf_state(job_id, **kwargs) Returns the Terraform state for the specified job.
get_stack(stack_id, **kwargs) Gets a stack using the stack ID.
get_stack_tf_config(stack_id, **kwargs) Returns the Terraform configuration file in .zip format for the specified stack.
get_stack_tf_state(stack_id, **kwargs) Returns the Terraform state for the specified stack.
get_work_request(work_request_id, **kwargs) Return the given work request.
list_jobs(**kwargs) Returns a list of jobs in a stack or compartment, ordered by time created.
list_stack_resource_drift_details(stack_id, …) Lists drift status details for each resource defined in the specified stack.
list_stacks(**kwargs) Returns a list of stacks.
list_terraform_versions(**kwargs) Returns a list of supported Terraform versions for use with stacks.
list_work_request_errors(work_request_id, …) Return a (paginated) list of errors for a given work request.
list_work_request_logs(work_request_id, **kwargs) Return a (paginated) list of logs for a given work request.
list_work_requests(compartment_id, **kwargs) Lists the work requests in a given compartment or for a given resource.
update_job(job_id, update_job_details, **kwargs) Updates the specified job.
update_stack(stack_id, update_stack_details, …) Updates the specified stack object.
__init__(config, **kwargs)

Creates a new service client

Parameters:
  • config (dict) – Configuration keys and values as per SDK and Tool Configuration. The from_file() method can be used to load configuration from a file. Alternatively, a dict can be passed. You can validate_config the dict using validate_config()
  • service_endpoint (str) – (optional) The endpoint of the service to call using this client. For example https://iaas.us-ashburn-1.oraclecloud.com. If this keyword argument is not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit need to specify a service endpoint.
  • timeout (float or tuple(float, float)) – (optional) The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout.
  • signer (AbstractBaseSigner) –

    (optional) The signer to use when signing requests made by the service client. The default is to use a Signer based on the values provided in the config parameter.

    One use case for this parameter is for Instance Principals authentication by passing an instance of InstancePrincipalsSecurityTokenSigner as the value for this keyword argument

  • retry_strategy (obj) –

    (optional) A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. Retry strategies can also be applied at the operation level by passing a retry_strategy keyword argument as part of calling the operation. Any value provided at the operation level will override whatever is specified at the client level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

cancel_job(job_id, **kwargs)

Indicates the intention to cancel the specified job. Cancellation of the job is not immediate, and may be delayed, or may not happen at all.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

change_stack_compartment(stack_id, change_stack_compartment_details, **kwargs)

Moves a Stack and it’s associated Jobs into a different compartment.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • change_stack_compartment_details (ChangeStackCompartmentDetails) – (required) Defines the properties of changeStackCompartment operation.
  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of retrying the same action. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

create_job(create_job_details, **kwargs)

Creates a job.

Parameters:
  • create_job_details (CreateJobDetails) – (required) The properties for a request to create a job.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of retrying the same action. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Job

Return type:

Response

create_stack(create_stack_details, **kwargs)

Creates a stack in the specified compartment. Specify the compartment using the compartment ID. For more information, see Create a Stack.

Parameters:
  • create_stack_details (CreateStackDetails) – (required) The properties for creating a stack.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of retrying the same action. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Stack

Return type:

Response

delete_stack(stack_id, **kwargs)

Deletes the specified stack object.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

detect_stack_drift(stack_id, **kwargs)

Checks drift status for the specified stack.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • opc_retry_token (str) – (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of retrying the same action. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type None

Return type:

Response

get_job(job_id, **kwargs)

Returns the specified job along with the job details.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Job

Return type:

Response

get_job_logs(job_id, **kwargs)

Returns log entries for the specified job in JSON format.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • type (list[LogEntryType]) – (optional) A filter that returns only logs of a specified type.
  • level_greater_than_or_equal_to (str) –

    (optional) A filter that returns only log entries that match a given severity level or greater.

    Allowed values are: “TRACE”, “DEBUG”, “INFO”, “WARN”, “ERROR”, “FATAL”

  • sort_order (str) –

    (optional) The sort order to use when sorting returned resources. Ascending (ASC) or descending (DESC).

    Allowed values are: “ASC”, “DESC”

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • timestamp_greater_than_or_equal_to (datetime) – (optional) Time stamp specifying the lower time limit for which logs are returned in a query.
  • timestamp_less_than_or_equal_to (datetime) – (optional) Time stamp specifying the upper time limit for which logs are returned in a query.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of LogEntry

Return type:

Response

get_job_logs_content(job_id, **kwargs)

Returns raw log file for the specified job in text format. Returns a maximum of 100,000 log entries.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type str

Return type:

Response

get_job_tf_config(job_id, **kwargs)

Returns the Terraform configuration file for the specified job in .zip format. Returns an error if no zip file is found.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type stream

Return type:

Response

get_job_tf_state(job_id, **kwargs)

Returns the Terraform state for the specified job.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type stream

Return type:

Response

get_stack(stack_id, **kwargs)

Gets a stack using the stack ID.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Stack

Return type:

Response

get_stack_tf_config(stack_id, **kwargs)

Returns the Terraform configuration file in .zip format for the specified stack. Returns an error if no zip file is found.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type stream

Return type:

Response

get_stack_tf_state(stack_id, **kwargs)

Returns the Terraform state for the specified stack.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type stream

Return type:

Response

get_work_request(work_request_id, **kwargs)

Return the given work request.

Parameters:
  • work_request_id (str) –

    (required) The OCID of the work request.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type WorkRequest

Return type:

Response

list_jobs(**kwargs)

Returns a list of jobs in a stack or compartment, ordered by time created.

  • To list all jobs in a stack, provide the stack OCID.
  • To list all jobs in a compartment, provide the compartment OCID.
  • To return a specific job, provide the job OCID.
Parameters:
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • compartment_id (str) –

    (optional) A filter to return only resources that exist in the compartment, identified by OCID.

  • stack_id (str) –

    (optional) The stack OCID on which to filter.

  • id (str) –

    (optional) The OCID on which to query for jobs.

  • lifecycle_state (str) –

    (optional) A filter that returns all resources that match the specified lifecycle state. The state value is case-insensitive.

    Allowable values: - ACCEPTED - IN_PROGRESS - FAILED - SUCCEEDED - CANCELING - CANCELED

    Allowed values are: “ACCEPTED”, “IN_PROGRESS”, “FAILED”, “SUCCEEDED”, “CANCELING”, “CANCELED”

  • display_name (str) – (optional) A filter to return only resources that match the specified display name.
  • sort_by (str) –

    (optional) The field to use when sorting returned resources. By default, TIMECREATED is ordered descending. By default, DISPLAYNAME is ordered ascending. Note that you can sort only on one field.

    Allowed values are: “TIMECREATED”, “DISPLAYNAME”

  • sort_order (str) –

    (optional) The sort order to use when sorting returned resources. Ascending (ASC) or descending (DESC).

    Allowed values are: “ASC”, “DESC”

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of JobSummary

Return type:

Response

list_stack_resource_drift_details(stack_id, **kwargs)

Lists drift status details for each resource defined in the specified stack. The drift status details for a given resource indicate differences, if any, between the actual state and the expected (defined) state for that resource.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • resource_drift_status (list[StackResourceDriftSummaryResourceDriftStatus]) –

    (optional) A filter that returns only resources that match the given drift status. The value is case-insensitive. Allowable values -

    • NOT_CHECKED
    • MODIFIED
    • IN_SYNC
    • DELETED
  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type StackResourceDriftCollection

Return type:

Response

list_stacks(**kwargs)

Returns a list of stacks. - If called using the compartment ID, returns all stacks in the specified compartment. - If called using the stack ID, returns the specified stack.

Parameters:
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • compartment_id (str) –

    (optional) A filter to return only resources that exist in the compartment, identified by OCID.

  • id (str) –

    (optional) The OCID on which to query for a stack.

  • lifecycle_state (str) –

    (optional) A filter that returns only those resources that match the specified lifecycle state. The state value is case-insensitive. For more information about stack lifecycle states, see Key Concepts.

    Allowable values: - CREATING - ACTIVE - DELETING - DELETED

    Allowed values are: “CREATING”, “ACTIVE”, “DELETING”, “DELETED”

  • display_name (str) – (optional) A filter to return only resources that match the specified display name.
  • sort_by (str) –

    (optional) The field to use when sorting returned resources. By default, TIMECREATED is ordered descending. By default, DISPLAYNAME is ordered ascending. Note that you can sort only on one field.

    Allowed values are: “TIMECREATED”, “DISPLAYNAME”

  • sort_order (str) –

    (optional) The sort order to use when sorting returned resources. Ascending (ASC) or descending (DESC).

    Allowed values are: “ASC”, “DESC”

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of StackSummary

Return type:

Response

list_terraform_versions(**kwargs)

Returns a list of supported Terraform versions for use with stacks.

Parameters:
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • compartment_id (str) –

    (optional) A filter to return only resources that exist in the compartment, identified by OCID.

  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type TerraformVersionCollection

Return type:

Response

list_work_request_errors(work_request_id, **kwargs)

Return a (paginated) list of errors for a given work request.

Parameters:
  • work_request_id (str) –

    (required) The OCID of the work request.

  • compartment_id (str) –

    (optional) A filter to return only resources that exist in the compartment, identified by OCID.

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • sort_order (str) –

    (optional) The sort order to use when sorting returned resources. Ascending (ASC) or descending (DESC).

    Allowed values are: “ASC”, “DESC”

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of WorkRequestError

Return type:

Response

list_work_request_logs(work_request_id, **kwargs)

Return a (paginated) list of logs for a given work request.

Parameters:
  • work_request_id (str) –

    (required) The OCID of the work request.

  • compartment_id (str) –

    (optional) A filter to return only resources that exist in the compartment, identified by OCID.

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • sort_order (str) –

    (optional) The sort order to use when sorting returned resources. Ascending (ASC) or descending (DESC).

    Allowed values are: “ASC”, “DESC”

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of WorkRequestLogEntry

Return type:

Response

list_work_requests(compartment_id, **kwargs)

Lists the work requests in a given compartment or for a given resource.

Parameters:
  • compartment_id (str) –

    (required) A filter to return only resources that exist in the compartment, identified by OCID.

  • resource_id (str) –

    (optional) The OCID of the resource.

  • limit (int) –

    (optional) The number of items returned in a paginated List call. For information about pagination, see List Pagination.

  • page (str) –

    (optional) The value of the opc-next-page response header from the preceding List call. For information about pagination, see List Pagination.

  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type list of WorkRequestSummary

Return type:

Response

update_job(job_id, update_job_details, **kwargs)

Updates the specified job.

Parameters:
  • job_id (str) –

    (required) The OCID of the job.

  • update_job_details (UpdateJobDetails) – (required) Updates properties for the specified job.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Job

Return type:

Response

update_stack(stack_id, update_stack_details, **kwargs)

Updates the specified stack object. Use UpdateStack when you update your Terraform configuration and want your changes to be reflected in the execution plan. For more information, see Update a Stack and Edit or Delete a Stack.

Parameters:
  • stack_id (str) –

    (required) The OCID of the stack.

  • update_stack_details (UpdateStackDetails) – (required) Updated information provided for the stack.
  • opc_request_id (str) – (optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
  • if_match (str) – (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource’s current etag value.
  • retry_strategy (obj) –

    (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.

    This should be one of the strategies available in the retry module. A convenience DEFAULT_RETRY_STRATEGY is also available. The specifics of the default retry strategy are described here.

    To have this operation explicitly not perform any retries, pass an instance of NoneRetryStrategy.

Returns:

A Response object with data of type Stack

Return type:

Response