compute_capacity_reports

Creates, updates, deletes, gets or lists a compute_capacity_reports resource.

Overview

Name	compute_capacity_reports
Type	Resource
Id	oci.compute.compute_capacity_reports

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create	insert	region, compartmentId, availabilityDomain, shapeAvailabilities	opc-request-id, opc-retry-token	Generates a report of the host capacity within an availability domain that is available for you<br />to create compute instances. Host capacity is the physical infrastructure that resources such as compute<br />instances run on.<br /><br />Use the capacity report to determine whether sufficient capacity is available for a shape before<br />you create an instance or change the shape of an instance.<br />

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	OCI region identifier (e.g. us-ashburn-1, ap-sydney-1); resolves from OCI_REGION when not supplied in the query. (default: us-ashburn-1, x-stackQL-envVar: OCI_REGION)
opc-request-id	string	Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
opc-retry-token	string	A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. 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).

INSERT examples

create

Generates a report of the host capacity within an availability domain that is available for you<br />to create compute instances. Host capacity is the physical infrastructure that resources such as compute<br />instances run on.<br /><br />Use the capacity report to determine whether sufficient capacity is available for a shape before<br />you create an instance or change the shape of an instance.<br />

INSERT INTO oci.compute.compute_capacity_reports (
availabilityDomain,
compartmentId,
shapeAvailabilities,
region,
opc-request-id,
opc-retry-token
)
SELECT 
'{{ availabilityDomain }}' /* required */,
'{{ compartmentId }}' /* required */,
'{{ shapeAvailabilities }}' /* required */,
'{{ region }}',
'{{ opc-request-id }}',
'{{ opc-retry-token }}'
RETURNING
availabilityDomain,
compartmentId,
shapeAvailabilities,
timeCreated
;

Manifest

# Description fields are for documentation purposes
- name: compute_capacity_reports
props:
  - name: region
    value: "{{ region }}"
    description: Required parameter for the compute_capacity_reports resource.
  - name: availabilityDomain
    value: "{{ availabilityDomain }}"
    description: |
      The availability domain for the capacity report.
      Example: `Uocm:PHX-AD-1`
  - name: compartmentId
    value: "{{ compartmentId }}"
    description: |
      The [OCID](/iaas/Content/General/Concepts/identifiers.htm) for the compartment. This should always be the root
      compartment.
  - name: shapeAvailabilities
    description: |
      Information about the shapes in the capacity report.
    value:
      - faultDomain: "{{ faultDomain }}"
        instanceShape: "{{ instanceShape }}"
        instanceShapeConfig:
          baselineOcpuUtilization: "{{ baselineOcpuUtilization }}"
          memoryInGBs: {{ memoryInGBs }}
          nvmes: {{ nvmes }}
          ocpus: {{ ocpus }}
  - name: opc-request-id
    value: "{{ opc-request-id }}"
    description: Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. 
    description: Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. 
  - name: opc-retry-token
    value: "{{ opc-retry-token }}"
    description: A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. 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). 
    description: A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. 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).