Pre-General Availability: 2022-08-18. This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.
Update the Project resource identified by the id
put
/20211130/projects/{projectId}
Updates the Project
Request
Path Parameters
-
projectId: string
Project OCID
Header Parameters
-
if-match(optional): string
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: string
The client request ID for tracing.
The information to be updated.
Root Schema : UpdateProjectDetails
Type:
object
The Project resource information to be updated.
Show Source
-
configuration(optional):
object ProjectLimits
Project level limits
-
definedTags(optional):
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}`
-
description(optional):
string
Minimum Length:
6
Maximum Length:2048
Description of the Project resource -
displayName(optional):
string
Minimum Length:
1
Maximum Length:255
Name of the Project resource -
freeformTags(optional):
object freeformTags
Additional Properties Allowed: additionalPropertiesSimple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}`
-
systemTags(optional):
object systemTags
Additional Properties Allowed: additionalPropertiesUsage of system tag keys. These predefined keys are scoped to namespaces. Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Nested Schema : ProjectLimits
Type:
object
Project level limits
Show Source
-
maxConcurrentQueries(optional):
integer
Minimum Value:
1
Maximum Value:15
Default Value:5
Max no. of concurrent queries running per project -
maxDataReadPerQueryInGBs(optional):
integer
Minimum Value:
1
Maximum Value:1024
Default Value:10
Max data read (in GB) per query. Default = 10GB -
maxOcpuTimeTakenPerQueryInSeconds(optional):
integer(int64)
Minimum Value:
60
Maximum Value:43200
Default Value:7200
Max OCPU time (in seconds) per query run after which the query will be aborted. Aborted queries will not be billed. Default = 2 hr (7200 sec) -
maxTimeTakenPerQueryInSeconds(optional):
integer
Minimum Value:
60
Maximum Value:43200
Default Value:7200
Max time (in seconds) per query run after which the query will be aborted. Aborted queries will not be billed. Default = 2 hr (7200 sec)
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing predefined tags' keys and values scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}`
Defined tags for this resource. Each key is predefined and scoped to a namespace.
Example: `{"foo-namespace": {"bar-key": "value"}}`
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Simple key-value pair that is applied without any predefined name, type or scope.
Exists for cross-compatibility only.
Example: `{"bar-key": "value"}`
Nested Schema : systemTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing system tags' keys and values scoped to a namespace. Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Usage of system tag keys. These predefined keys are scoped to namespaces.
Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only string, integer and boolean types are supported.
Key-value pair representing predefined tags' keys and values scoped to a namespace.
Example: `{"foo-namespace": {"bar-key": "value"}}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only string, integer and boolean types are supported.
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only string, integer and boolean types are supported.
Key-value pair representing system tags' keys and values scoped to a namespace.
Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only string, integer and boolean types are supported.
Response
Supported Media Types
- application/json
200 Response
The Project resource is updated.
Headers
-
etag: string
For optimistic concurrency control. See `if-match`.
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Project
Type:
object
Project resource.
Show Source
-
compartmentId:
string
Minimum Length:
1
Maximum Length:255
The OCID of the compartment -
configuration:
object ProjectLimits
Project level limits
-
dataCatalogId(optional):
string
Data Catalog OCID
-
definedTags(optional):
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}`
-
description(optional):
string
Minimum Length:
6
Maximum Length:2048
Description of the Project resource -
displayName:
string
Minimum Length:
1
Maximum Length:255
Name of the Project resource -
freeformTags(optional):
object freeformTags
Additional Properties Allowed: additionalPropertiesSimple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}`
-
id:
string
Minimum Length:
1
Maximum Length:255
The OCID of the Project resource -
jdbcConnection(optional):
string
URL for jdbc connectionExample:
jdbc://oracle:default-connection
-
lifecycleState:
string
Allowed Values:
[ "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED" ]
The current state of the Project resource. -
systemTags(optional):
object systemTags
Additional Properties Allowed: additionalPropertiesUsage of system tag keys. These predefined keys are scoped to namespaces. Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
-
timeCreated:
string(date-time)
The time the Project instance was created. An RFC3339 formatted datetime stringExample:
2019-03-29T09:36:42.000Z
-
timeUpdated(optional):
string(date-time)
The time the Project instance was updated. An RFC3339 formatted datetime stringExample:
2019-03-29T09:36:42.000Z
Nested Schema : ProjectLimits
Type:
object
Project level limits
Show Source
-
maxConcurrentQueries(optional):
integer
Minimum Value:
1
Maximum Value:15
Default Value:5
Max no. of concurrent queries running per project -
maxDataReadPerQueryInGBs(optional):
integer
Minimum Value:
1
Maximum Value:1024
Default Value:10
Max data read (in GB) per query. Default = 10GB -
maxOcpuTimeTakenPerQueryInSeconds(optional):
integer(int64)
Minimum Value:
60
Maximum Value:43200
Default Value:7200
Max OCPU time (in seconds) per query run after which the query will be aborted. Aborted queries will not be billed. Default = 2 hr (7200 sec) -
maxTimeTakenPerQueryInSeconds(optional):
integer
Minimum Value:
60
Maximum Value:43200
Default Value:7200
Max time (in seconds) per query run after which the query will be aborted. Aborted queries will not be billed. Default = 2 hr (7200 sec)
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing predefined tags' keys and values scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}`
Defined tags for this resource. Each key is predefined and scoped to a namespace.
Example: `{"foo-namespace": {"bar-key": "value"}}`
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Simple key-value pair that is applied without any predefined name, type or scope.
Exists for cross-compatibility only.
Example: `{"bar-key": "value"}`
Nested Schema : systemTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing system tags' keys and values scoped to a namespace. Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Usage of system tag keys. These predefined keys are scoped to namespaces.
Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only string, integer and boolean types are supported.
Key-value pair representing predefined tags' keys and values scoped to a namespace.
Example: `{"foo-namespace": {"bar-key": "value"}}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only string, integer and boolean types are supported.
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only string, integer and boolean types are supported.
Key-value pair representing system tags' keys and values scoped to a namespace.
Example: `{ "orcl-cloud": { "free-tier-retained": "true" } }`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only string, integer and boolean types are supported.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
412 Response
Precondition failed
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.
Default Response
Unknown Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : DefaultError
Type:
object
Error Information.
Show Source
-
code:
string
Minimum Length:
1
Maximum Length:255
A short error code that defines the error, meant for programmatic parsing. -
message:
string
Minimum Length:
1
Maximum Length:1024
A human-readable error string.