oci 2.3.5 → 2.3.6

Sign up to get free protection for your applications and to get access to all the features.
Files changed (101) hide show
  1. checksums.yaml +5 -5
  2. data/README.md +1 -1
  3. data/lib/oci/core/blockstorage_client.rb +23 -23
  4. data/lib/oci/core/compute_client.rb +26 -21
  5. data/lib/oci/core/models/boot_volume.rb +5 -2
  6. data/lib/oci/core/models/boot_volume_attachment.rb +4 -1
  7. data/lib/oci/core/models/boot_volume_backup.rb +3 -0
  8. data/lib/oci/core/models/console_history.rb +4 -1
  9. data/lib/oci/core/models/cpe.rb +4 -1
  10. data/lib/oci/core/models/create_boot_volume_details.rb +2 -2
  11. data/lib/oci/core/models/create_internet_gateway_details.rb +2 -2
  12. data/lib/oci/core/models/create_service_gateway_details.rb +2 -2
  13. data/lib/oci/core/models/create_subnet_details.rb +1 -1
  14. data/lib/oci/core/models/create_volume_details.rb +2 -2
  15. data/lib/oci/core/models/create_volume_group_details.rb +2 -2
  16. data/lib/oci/core/models/cross_connect.rb +3 -0
  17. data/lib/oci/core/models/cross_connect_group.rb +3 -0
  18. data/lib/oci/core/models/dhcp_dns_option.rb +7 -6
  19. data/lib/oci/core/models/dhcp_options.rb +3 -0
  20. data/lib/oci/core/models/drg.rb +4 -1
  21. data/lib/oci/core/models/drg_attachment.rb +3 -0
  22. data/lib/oci/core/models/image.rb +3 -0
  23. data/lib/oci/core/models/instance.rb +15 -7
  24. data/lib/oci/core/models/internet_gateway.rb +9 -6
  25. data/lib/oci/core/models/ip_sec_connection.rb +3 -0
  26. data/lib/oci/core/models/launch_instance_details.rb +9 -5
  27. data/lib/oci/core/models/local_peering_gateway.rb +3 -0
  28. data/lib/oci/core/models/private_ip.rb +4 -1
  29. data/lib/oci/core/models/public_ip.rb +8 -5
  30. data/lib/oci/core/models/remote_peering_connection.rb +3 -0
  31. data/lib/oci/core/models/route_table.rb +3 -0
  32. data/lib/oci/core/models/security_list.rb +3 -0
  33. data/lib/oci/core/models/service_gateway.rb +3 -0
  34. data/lib/oci/core/models/subnet.rb +5 -2
  35. data/lib/oci/core/models/update_instance_details.rb +46 -4
  36. data/lib/oci/core/models/vcn.rb +4 -1
  37. data/lib/oci/core/models/virtual_circuit.rb +3 -0
  38. data/lib/oci/core/models/vnic.rb +4 -1
  39. data/lib/oci/core/models/vnic_attachment.rb +4 -1
  40. data/lib/oci/core/models/volume.rb +5 -2
  41. data/lib/oci/core/models/volume_attachment.rb +4 -1
  42. data/lib/oci/core/models/volume_backup.rb +3 -0
  43. data/lib/oci/core/models/volume_backup_policy.rb +7 -1
  44. data/lib/oci/core/models/volume_group.rb +6 -1
  45. data/lib/oci/core/models/volume_group_backup.rb +3 -0
  46. data/lib/oci/core/virtual_network_client.rb +60 -60
  47. data/lib/oci/core/virtual_network_client_composite_operations.rb +4 -4
  48. data/lib/oci/database/database_client.rb +56 -60
  49. data/lib/oci/database/database_client_composite_operations.rb +6 -6
  50. data/lib/oci/database/models/autonomous_data_warehouse.rb +3 -1
  51. data/lib/oci/database/models/autonomous_data_warehouse_backup.rb +3 -1
  52. data/lib/oci/database/models/autonomous_data_warehouse_backup_summary.rb +3 -1
  53. data/lib/oci/database/models/autonomous_data_warehouse_summary.rb +3 -1
  54. data/lib/oci/database/models/autonomous_database.rb +3 -1
  55. data/lib/oci/database/models/autonomous_database_backup.rb +3 -1
  56. data/lib/oci/database/models/autonomous_database_backup_summary.rb +3 -1
  57. data/lib/oci/database/models/autonomous_database_summary.rb +3 -1
  58. data/lib/oci/database/models/backup.rb +11 -9
  59. data/lib/oci/database/models/backup_summary.rb +11 -9
  60. data/lib/oci/database/models/create_autonomous_data_warehouse_backup_details.rb +2 -0
  61. data/lib/oci/database/models/create_autonomous_data_warehouse_details.rb +3 -1
  62. data/lib/oci/database/models/create_autonomous_database_backup_details.rb +2 -0
  63. data/lib/oci/database/models/create_autonomous_database_details.rb +4 -2
  64. data/lib/oci/database/models/create_backup_details.rb +6 -3
  65. data/lib/oci/database/models/create_data_guard_association_to_existing_db_system_details.rb +1 -1
  66. data/lib/oci/database/models/create_database_details.rb +9 -6
  67. data/lib/oci/database/models/create_database_from_backup_details.rb +1 -1
  68. data/lib/oci/database/models/create_db_home_details.rb +5 -2
  69. data/lib/oci/database/models/create_db_home_from_backup_details.rb +4 -1
  70. data/lib/oci/database/models/create_db_home_with_db_system_id_base.rb +6 -5
  71. data/lib/oci/database/models/create_db_home_with_db_system_id_details.rb +1 -1
  72. data/lib/oci/database/models/data_guard_association.rb +1 -1
  73. data/lib/oci/database/models/data_guard_association_summary.rb +1 -1
  74. data/lib/oci/database/models/database.rb +8 -6
  75. data/lib/oci/database/models/database_summary.rb +8 -6
  76. data/lib/oci/database/models/db_home.rb +11 -10
  77. data/lib/oci/database/models/db_home_summary.rb +11 -10
  78. data/lib/oci/database/models/db_node.rb +10 -8
  79. data/lib/oci/database/models/db_node_summary.rb +10 -8
  80. data/lib/oci/database/models/db_system.rb +46 -42
  81. data/lib/oci/database/models/db_system_shape_summary.rb +4 -4
  82. data/lib/oci/database/models/db_system_summary.rb +46 -42
  83. data/lib/oci/database/models/db_version_summary.rb +2 -2
  84. data/lib/oci/database/models/failover_data_guard_association_details.rb +1 -1
  85. data/lib/oci/database/models/launch_db_system_base.rb +38 -27
  86. data/lib/oci/database/models/launch_db_system_details.rb +6 -6
  87. data/lib/oci/database/models/launch_db_system_from_backup_details.rb +8 -8
  88. data/lib/oci/database/models/patch.rb +2 -2
  89. data/lib/oci/database/models/patch_details.rb +2 -2
  90. data/lib/oci/database/models/patch_history_entry.rb +2 -2
  91. data/lib/oci/database/models/patch_history_entry_summary.rb +2 -2
  92. data/lib/oci/database/models/patch_summary.rb +2 -2
  93. data/lib/oci/database/models/reinstate_data_guard_association_details.rb +1 -1
  94. data/lib/oci/database/models/switchover_data_guard_association_details.rb +1 -1
  95. data/lib/oci/database/models/update_autonomous_data_warehouse_details.rb +4 -2
  96. data/lib/oci/database/models/update_autonomous_database_details.rb +4 -2
  97. data/lib/oci/database/models/update_database_details.rb +4 -1
  98. data/lib/oci/database/models/update_db_home_details.rb +1 -1
  99. data/lib/oci/database/models/update_db_system_details.rb +6 -4
  100. data/lib/oci/version.rb +1 -1
  101. metadata +3 -4
@@ -4,14 +4,14 @@ require 'date'
4
4
 
5
5
  # rubocop:disable Lint/UnneededCopDisableDirective
6
6
  module OCI
7
- # The shape of the DB System. The shape determines resources to allocate to the DB system - CPU cores and memory for VM shapes; CPU cores, memory and storage for non-VM (or bare metal) shapes.
7
+ # The shape of the DB system. The shape determines resources to allocate to the DB system - CPU cores and memory for VM shapes; CPU cores, memory and storage for non-VM (or bare metal) shapes.
8
8
  # For a description of shapes, see [DB System Launch Options](https://docs.us-phoenix-1.oraclecloud.com/Content/Database/References/launchoptions.htm).
9
9
  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator.
10
10
  # If you're an administrator who needs to write policies to give users access,
11
11
  # see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
12
12
  #
13
13
  class Database::Models::DbSystemShapeSummary # rubocop:disable Metrics/LineLength
14
- # **[Required]** The maximum number of CPU cores that can be enabled on the DB System for this shape.
14
+ # **[Required]** The maximum number of CPU cores that can be enabled on the DB system for this shape.
15
15
  # @return [Integer]
16
16
  attr_accessor :available_core_count
17
17
 
@@ -23,7 +23,7 @@ module OCI
23
23
  # @return [Integer]
24
24
  attr_accessor :maximum_node_count
25
25
 
26
- # The minimum number of CPU cores that can be enabled on the DB System for this shape.
26
+ # The minimum number of CPU cores that can be enabled on the DB system for this shape.
27
27
  # @return [Integer]
28
28
  attr_accessor :minimum_core_count
29
29
 
@@ -31,7 +31,7 @@ module OCI
31
31
  # @return [Integer]
32
32
  attr_accessor :minimum_node_count
33
33
 
34
- # **[Required]** The name of the shape used for the DB System.
34
+ # **[Required]** The name of the shape used for the DB system.
35
35
  # @return [String]
36
36
  attr_accessor :name
37
37
 
@@ -5,28 +5,30 @@ require 'logger'
5
5
 
6
6
  # rubocop:disable Lint/UnneededCopDisableDirective
7
7
  module OCI
8
- # The Database Service supports several types of DB Systems, ranging in size, price, and performance. For details about each type of system, see:
8
+ # The Database Service supports several types of DB systems, ranging in size, price, and performance. For details about each type of system, see:
9
9
  #
10
10
  # - [Exadata DB Systems](https://docs.us-phoenix-1.oraclecloud.com/Content/Database/Concepts/exaoverview.htm)
11
11
  # - [Bare Metal and Virtual Machine DB Systems](https://docs.us-phoenix-1.oraclecloud.com/Content/Database/Concepts/overview.htm)
12
12
  #
13
- # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
13
+ # To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized, talk to an administrator. If you are an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
14
14
  #
15
15
  # For information about access control and compartments, see
16
16
  # [Overview of the Identity Service](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/overview.htm).
17
17
  #
18
- # For information about Availability Domains, see
18
+ # For information about availability domains, see
19
19
  # [Regions and Availability Domains](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm).
20
20
  #
21
- # To get a list of Availability Domains, use the `ListAvailabilityDomains` operation
21
+ # To get a list of availability domains, use the `ListAvailabilityDomains` operation
22
22
  # in the Identity Service API.
23
23
  #
24
+ # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
25
+ #
24
26
  class Database::Models::DbSystemSummary # rubocop:disable Metrics/LineLength
25
27
  DATABASE_EDITION_ENUM = [
26
28
  DATABASE_EDITION_STANDARD_EDITION = 'STANDARD_EDITION'.freeze,
27
29
  DATABASE_EDITION_ENTERPRISE_EDITION = 'ENTERPRISE_EDITION'.freeze,
28
- DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = 'ENTERPRISE_EDITION_EXTREME_PERFORMANCE'.freeze,
29
30
  DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = 'ENTERPRISE_EDITION_HIGH_PERFORMANCE'.freeze,
31
+ DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = 'ENTERPRISE_EDITION_EXTREME_PERFORMANCE'.freeze,
30
32
  DATABASE_EDITION_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
31
33
  ].freeze
32
34
 
@@ -52,43 +54,42 @@ module OCI
52
54
  LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
53
55
  ].freeze
54
56
 
55
- # **[Required]** The name of the Availability Domain that the DB System is located in.
57
+ # **[Required]** The name of the availability domain that the DB system is located in.
56
58
  # @return [String]
57
59
  attr_accessor :availability_domain
58
60
 
59
- # The OCID of the backup network subnet the DB System is associated with. Applicable only to Exadata.
61
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the backup network subnet the DB system is associated with. Applicable only to Exadata DB systems.
60
62
  #
61
- # **Subnet Restriction:** See above subnetId's 'Subnet Restriction'.
62
- # to malfunction.
63
+ # **Subnet Restriction:** See the subnet restrictions information for **subnetId**.
63
64
  #
64
65
  # @return [String]
65
66
  attr_accessor :backup_subnet_id
66
67
 
67
- # Cluster name for Exadata and 2-node RAC DB Systems. The cluster name must begin with an an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive.
68
+ # The cluster name for Exadata and 2-node RAC virtual machine DB systems. The cluster name must begin with an an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive.
68
69
  #
69
70
  # @return [String]
70
71
  attr_accessor :cluster_name
71
72
 
72
- # **[Required]** The OCID of the compartment.
73
+ # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
73
74
  # @return [String]
74
75
  attr_accessor :compartment_id
75
76
 
76
- # **[Required]** The number of CPU cores enabled on the DB System.
77
+ # **[Required]** The number of CPU cores enabled on the DB system.
77
78
  # @return [Integer]
78
79
  attr_accessor :cpu_core_count
79
80
 
80
81
  # The percentage assigned to DATA storage (user data and database files).
81
- # The remaining percentage is assigned to RECO storage (database redo logs, archive logs, and recovery manager backups). Accepted values are 40 and 80.
82
+ # The remaining percentage is assigned to RECO storage (database redo logs, archive logs, and recovery manager backups). Accepted values are 40 and 80. The default is 80 percent assigned to DATA storage. Not applicable for virtual machine DB systems.
82
83
  #
83
84
  # @return [Integer]
84
85
  attr_accessor :data_storage_percentage
85
86
 
86
- # Data storage size, in GBs, that is currently available to the DB system. This is applicable only for VM-based DBs.
87
+ # The data storage size, in gigabytes, that is currently available to the DB system. Applies only for virtual machine DB systems.
87
88
  #
88
89
  # @return [Integer]
89
90
  attr_accessor :data_storage_size_in_gbs
90
91
 
91
- # **[Required]** The Oracle Database Edition that applies to all the databases on the DB System.
92
+ # **[Required]** The Oracle Database edition that applies to all the databases on the DB system.
92
93
  #
93
94
  # @return [String]
94
95
  attr_reader :database_edition
@@ -101,18 +102,18 @@ module OCI
101
102
  # @return [Hash<String, Hash<String, Object>>]
102
103
  attr_accessor :defined_tags
103
104
 
104
- # The type of redundancy configured for the DB System.
105
- # Normal is 2-way redundancy.
106
- # High is 3-way redundancy.
105
+ # The type of redundancy configured for the DB system.
106
+ # NORMAL is 2-way redundancy.
107
+ # HIGH is 3-way redundancy.
107
108
  #
108
109
  # @return [String]
109
110
  attr_reader :disk_redundancy
110
111
 
111
- # **[Required]** The user-friendly name for the DB System. It does not have to be unique.
112
+ # **[Required]** The user-friendly name for the DB system. The name does not have to be unique.
112
113
  # @return [String]
113
114
  attr_accessor :display_name
114
115
 
115
- # **[Required]** The domain name for the DB System.
116
+ # **[Required]** The domain name for the DB system.
116
117
  # @return [String]
117
118
  attr_accessor :domain
118
119
 
@@ -124,19 +125,19 @@ module OCI
124
125
  # @return [Hash<String, String>]
125
126
  attr_accessor :freeform_tags
126
127
 
127
- # **[Required]** The host name for the DB Node.
128
+ # **[Required]** The hostname for the DB system.
128
129
  # @return [String]
129
130
  attr_accessor :hostname
130
131
 
131
- # **[Required]** The OCID of the DB System.
132
+ # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the DB system.
132
133
  # @return [String]
133
134
  attr_accessor :id
134
135
 
135
- # The OCID of the last patch history. This is updated as soon as a patch operation is started.
136
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the last patch history. This value is updated as soon as a patch operation starts.
136
137
  # @return [String]
137
138
  attr_accessor :last_patch_history_entry_id
138
139
 
139
- # The Oracle license model that applies to all the databases on the DB System. The default is BRING_YOUR_OWN_LICENSE.
140
+ # The Oracle license model that applies to all the databases on the DB system. The default is LICENSE_INCLUDED.
140
141
  #
141
142
  # @return [String]
142
143
  attr_reader :license_model
@@ -145,51 +146,54 @@ module OCI
145
146
  # @return [String]
146
147
  attr_accessor :lifecycle_details
147
148
 
148
- # **[Required]** The current state of the DB System.
149
+ # **[Required]** The current state of the DB system.
149
150
  # @return [String]
150
151
  attr_reader :lifecycle_state
151
152
 
152
- # The port number configured for the listener on the DB System.
153
+ # The port number configured for the listener on the DB system.
153
154
  # @return [Integer]
154
155
  attr_accessor :listener_port
155
156
 
156
- # Number of nodes in this DB system. For RAC DBs, this will be greater than 1.
157
+ # The number of nodes in the DB system. For RAC DB systems, the value is greater than 1.
157
158
  #
158
159
  # @return [Integer]
159
160
  attr_accessor :node_count
160
161
 
161
- # RECO/REDO storage size, in GBs, that is currently allocated to the DB system. This is applicable only for VM-based DBs.
162
+ # The RECO/REDO storage size, in gigabytes, that is currently allocated to the DB system. Applies only for virtual machine DB systems.
162
163
  #
163
164
  # @return [Integer]
164
165
  attr_accessor :reco_storage_size_in_gb
165
166
 
166
- # The OCID of the DNS record for the SCAN IP addresses that are associated with the DB System.
167
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the DNS record for the SCAN IP addresses that are associated with the DB system.
167
168
  #
168
169
  # @return [String]
169
170
  attr_accessor :scan_dns_record_id
170
171
 
171
- # The OCID of the Single Client Access Name (SCAN) IP addresses associated with the DB System.
172
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the Single Client Access Name (SCAN) IP addresses associated with the DB system.
172
173
  # SCAN IP addresses are typically used for load balancing and are not assigned to any interface.
173
- # Clusterware directs the requests to the appropriate nodes in the cluster.
174
+ # Oracle Clusterware directs the requests to the appropriate nodes in the cluster.
174
175
  #
175
- # - For a single-node DB System, this list is empty.
176
+ # **Note:** For a single-node DB system, this list is empty.
176
177
  #
177
178
  # @return [Array<String>]
178
179
  attr_accessor :scan_ip_ids
179
180
 
180
- # **[Required]** The shape of the DB System. The shape determines resources to allocate to the DB system - CPU cores and memory for VM shapes; CPU cores, memory and storage for non-VM (or bare metal) shapes.
181
+ # **[Required]** The shape of the DB system. The shape determines resources to allocate to the DB system.
182
+ # - For virtual machine shapes, the number of CPU cores and memory
183
+ # - For bare metal and Exadata shapes, the number of CPU cores, storage, and memory
184
+ #
181
185
  # @return [String]
182
186
  attr_accessor :shape
183
187
 
184
- # **[Required]** The public key portion of one or more key pairs used for SSH access to the DB System.
188
+ # **[Required]** The public key portion of one or more key pairs used for SSH access to the DB system.
185
189
  # @return [Array<String>]
186
190
  attr_accessor :ssh_public_keys
187
191
 
188
- # **[Required]** The OCID of the subnet the DB System is associated with.
192
+ # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the subnet the DB system is associated with.
189
193
  #
190
194
  # **Subnet Restrictions:**
191
- # - For single node and 2-node (RAC) DB Systems, do not use a subnet that overlaps with 192.168.16.16/28
192
- # - For Exadata and VM-based RAC DB Systems, do not use a subnet that overlaps with 192.168.128.0/20
195
+ # - For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
196
+ # - For Exadata and virtual machine 2-node RAC DB systems, do not use a subnet that overlaps with 192.168.128.0/20.
193
197
  #
194
198
  # These subnets are used by the Oracle Clusterware private interconnect on the database instance.
195
199
  # Specifying an overlapping subnet will cause the private interconnect to malfunction.
@@ -198,19 +202,19 @@ module OCI
198
202
  # @return [String]
199
203
  attr_accessor :subnet_id
200
204
 
201
- # The date and time the DB System was created.
205
+ # The date and time the DB system was created.
202
206
  # @return [DateTime]
203
207
  attr_accessor :time_created
204
208
 
205
- # The version of the DB System.
209
+ # The Oracle Database version of the DB system.
206
210
  # @return [String]
207
211
  attr_accessor :version
208
212
 
209
- # The OCID of the virtual IP (VIP) addresses associated with the DB System.
210
- # The Cluster Ready Services (CRS) creates and maintains one VIP address for each node in the DB System to
213
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the virtual IP (VIP) addresses associated with the DB system.
214
+ # The Cluster Ready Services (CRS) creates and maintains one VIP address for each node in the DB system to
211
215
  # enable failover. If one node fails, the VIP is reassigned to another active node in the cluster.
212
216
  #
213
- # - For a single-node DB System, this list is empty.
217
+ # **Note:** For a single-node DB system, this list is empty.
214
218
  #
215
219
  # @return [Array<String>]
216
220
  attr_accessor :vip_ids
@@ -9,11 +9,11 @@ module OCI
9
9
  # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
10
10
  #
11
11
  class Database::Models::DbVersionSummary # rubocop:disable Metrics/LineLength
12
- # True if this version of the Oracle database software supports pluggable dbs.
12
+ # True if this version of the Oracle Database software supports pluggable databases.
13
13
  # @return [BOOLEAN]
14
14
  attr_accessor :supports_pdb
15
15
 
16
- # **[Required]** A valid Oracle database version.
16
+ # **[Required]** A valid Oracle Database version.
17
17
  # @return [String]
18
18
  attr_accessor :version
19
19
 
@@ -7,7 +7,7 @@ module OCI
7
7
  # The Data Guard association failover parameters.
8
8
  #
9
9
  class Database::Models::FailoverDataGuardAssociationDetails # rubocop:disable Metrics/LineLength
10
- # **[Required]** The DB System administrator password.
10
+ # **[Required]** The DB system administrator password.
11
11
  # @return [String]
12
12
  attr_accessor :database_admin_password
13
13
 
@@ -4,7 +4,10 @@ require 'date'
4
4
 
5
5
  # rubocop:disable Lint/UnneededCopDisableDirective
6
6
  module OCI
7
- # LaunchDbSystemBase model.
7
+ # Parameters for provisioning a bare metal, virtual machine, or Exadata DB system.
8
+ #
9
+ # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
10
+ #
8
11
  # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
9
12
  class Database::Models::LaunchDbSystemBase # rubocop:disable Metrics/LineLength
10
13
  SOURCE_ENUM = [
@@ -12,42 +15,46 @@ module OCI
12
15
  SOURCE_DB_BACKUP = 'DB_BACKUP'.freeze
13
16
  ].freeze
14
17
 
15
- # **[Required]** The Availability Domain where the DB System is located.
18
+ # **[Required]** The availability domain where the DB system is located.
16
19
  # @return [String]
17
20
  attr_accessor :availability_domain
18
21
 
19
- # The OCID of the backup network subnet the DB System is associated with. Applicable only to Exadata.
22
+ # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the backup network subnet the DB system is associated with. Applicable only to Exadata DB systems.
20
23
  #
21
- # **Subnet Restrictions:** See above subnetId's **Subnet Restriction**.
24
+ # **Subnet Restrictions:** See the subnet restrictions information for **subnetId**.
22
25
  #
23
26
  # @return [String]
24
27
  attr_accessor :backup_subnet_id
25
28
 
26
- # Cluster name for Exadata and 2-node RAC DB Systems. The cluster name must begin with an an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive.
29
+ # The cluster name for Exadata and 2-node RAC virtual machine DB systems. The cluster name must begin with an an alphabetic character, and may contain hyphens (-). Underscores (_) are not permitted. The cluster name can be no longer than 11 characters and is not case sensitive.
27
30
  #
28
31
  # @return [String]
29
32
  attr_accessor :cluster_name
30
33
 
31
- # **[Required]** The Oracle Cloud ID (OCID) of the compartment the DB System belongs in.
34
+ # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment the DB system belongs in.
32
35
  # @return [String]
33
36
  attr_accessor :compartment_id
34
37
 
35
- # **[Required]** The number of CPU cores to enable. The valid values depend on the specified shape:
38
+ # **[Required]** The number of CPU cores to enable for a bare metal or Exadata DB system. The valid values depend on the specified shape:
36
39
  #
37
- # - BM.DenseIO1.36 and BM.HighIO1.36 - Specify a multiple of 2, from 2 to 36.
38
- # - BM.RACLocalStorage1.72 - Specify a multiple of 4, from 4 to 72.
40
+ # - BM.DenseIO1.36 - Specify a multiple of 2, from 2 to 36.
41
+ # - BM.DenseIO2.52 - Specify a multiple of 2, from 2 to 52.
39
42
  # - Exadata.Quarter1.84 - Specify a multiple of 2, from 22 to 84.
40
43
  # - Exadata.Half1.168 - Specify a multiple of 4, from 44 to 168.
41
44
  # - Exadata.Full1.336 - Specify a multiple of 8, from 88 to 336.
45
+ # - Exadata.Quarter2.92 - Specify a multiple of 2, from 0 to 92.
46
+ # - Exadata.Half2.184 - Specify a multiple of 4, from 0 to 184.
47
+ # - Exadata.Full2.368 - Specify a multiple of 8, from 0 to 368.
42
48
  #
43
- # For VM DB systems, the core count is inferred from the specific VM shape chosen, so this parameter is not used.
49
+ # This parameter is not used for virtual machine DB systems because virtual machine DB systems have a set number of cores for each shape.
50
+ # For information about the number of cores for a virtual machine DB system shape, see [Virtual Machine DB Systems](https://docs.us-phoenix-1.oraclecloud.com/Content/Database/Concepts/overview.htm#virtualmachine)
44
51
  #
45
52
  # @return [Integer]
46
53
  attr_accessor :cpu_core_count
47
54
 
48
55
  # The percentage assigned to DATA storage (user data and database files).
49
56
  # The remaining percentage is assigned to RECO storage (database redo logs, archive logs, and recovery manager backups).
50
- # Specify 80 or 40. The default is 80 percent assigned to DATA storage. This is not applicable for VM based DB systems.
57
+ # Specify 80 or 40. The default is 80 percent assigned to DATA storage. Not applicable for virtual machine DB systems.
51
58
  #
52
59
  # @return [Integer]
53
60
  attr_accessor :data_storage_percentage
@@ -60,13 +67,13 @@ module OCI
60
67
  # @return [Hash<String, Hash<String, Object>>]
61
68
  attr_accessor :defined_tags
62
69
 
63
- # The user-friendly name for the DB System. It does not have to be unique.
70
+ # The user-friendly name for the DB system. The name does not have to be unique.
64
71
  # @return [String]
65
72
  attr_accessor :display_name
66
73
 
67
- # A domain name used for the DB System. If the Oracle-provided Internet and VCN
74
+ # A domain name used for the DB system. If the Oracle-provided Internet and VCN
68
75
  # Resolver is enabled for the specified subnet, the domain name for the subnet is used
69
- # (don't provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted.
76
+ # (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted.
70
77
  #
71
78
  # @return [String]
72
79
  attr_accessor :domain
@@ -79,51 +86,55 @@ module OCI
79
86
  # @return [Hash<String, String>]
80
87
  attr_accessor :freeform_tags
81
88
 
82
- # **[Required]** The host name for the DB System. The host name must begin with an alphabetic character and
89
+ # **[Required]** The hostname for the DB system. The hostname must begin with an alphabetic character and
83
90
  # can contain a maximum of 30 alphanumeric characters, including hyphens (-).
84
91
  #
85
92
  # The maximum length of the combined hostname and domain is 63 characters.
86
93
  #
87
94
  # **Note:** The hostname must be unique within the subnet. If it is not unique,
88
- # the DB System will fail to provision.
95
+ # the DB system will fail to provision.
89
96
  #
90
97
  # @return [String]
91
98
  attr_accessor :hostname
92
99
 
93
- # Size, in GBs, of the initial data volume that will be created and attached to VM-shape based DB system. This storage can later be scaled up if needed. Note that the total storage size attached will be more than what is requested, to account for REDO/RECO space and software volume.
100
+ # Size (in GB) of the initial data volume that will be created and attached to a virtual machine DB system. You can scale up storage after provisioning, as needed. Note that the total storage size attached will be more than the amount you specify to allow for REDO/RECO space and software volume.
94
101
  #
95
102
  # @return [Integer]
96
103
  attr_accessor :initial_data_storage_size_in_gb
97
104
 
98
- # Number of nodes to launch for a VM-shape based RAC DB system.
105
+ # The number of nodes to launch for a 2-node RAC virtual machine DB system.
99
106
  #
100
107
  # @return [Integer]
101
108
  attr_accessor :node_count
102
109
 
103
- # **[Required]** The shape of the DB System. The shape determines resources allocated to the DB System - CPU cores and memory for VM shapes; CPU cores, memory and storage for non-VM (or bare metal) shapes. To get a list of shapes, use the {#list_db_system_shapes list_db_system_shapes} operation.
110
+ # **[Required]** The shape of the DB system. The shape determines resources allocated to the DB system.
111
+ # - For virtual machine shapes, the number of CPU cores and memory
112
+ # - For bare metal and Exadata shapes, the number of CPU cores, memory, and storage
113
+ #
114
+ # To get a list of shapes, use the {#list_db_system_shapes list_db_system_shapes} operation.
115
+ #
104
116
  # @return [String]
105
117
  attr_accessor :shape
106
118
 
107
- # Source of database:
108
- # NONE for creating a new database
109
- # DB_BACKUP for creating a new database by restoring a backup
119
+ # The source of the database:
120
+ # NONE for creating a new database. DB_BACKUP for creating a new database by restoring from a backup. The default is NONE.
110
121
  #
111
122
  # @return [String]
112
123
  attr_reader :source
113
124
 
114
- # **[Required]** The public key portion of the key pair to use for SSH access to the DB System. Multiple public keys can be provided. The length of the combined keys cannot exceed 10,000 characters.
125
+ # **[Required]** The public key portion of the key pair to use for SSH access to the DB system. Multiple public keys can be provided. The length of the combined keys cannot exceed 10,000 characters.
115
126
  # @return [Array<String>]
116
127
  attr_accessor :ssh_public_keys
117
128
 
118
- # **[Required]** The OCID of the subnet the DB System is associated with.
129
+ # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the subnet the DB system is associated with.
119
130
  #
120
131
  # **Subnet Restrictions:**
121
- # - For single node and 2-node (RAC) DB Systems, do not use a subnet that overlaps with 192.168.16.16/28
122
- # - For Exadata and VM-based RAC DB Systems, do not use a subnet that overlaps with 192.168.128.0/20
132
+ # - For bare metal DB systems and for single node virtual machine DB systems, do not use a subnet that overlaps with 192.168.16.16/28.
133
+ # - For Exadata and virtual machine 2-node RAC DB systems, do not use a subnet that overlaps with 192.168.128.0/20.
123
134
  #
124
135
  # These subnets are used by the Oracle Clusterware private interconnect on the database instance.
125
136
  # Specifying an overlapping subnet will cause the private interconnect to malfunction.
126
- # This restriction applies to both the client subnet and backup subnet.
137
+ # This restriction applies to both the client subnet and the backup subnet.
127
138
  #
128
139
  # @return [String]
129
140
  attr_accessor :subnet_id
@@ -10,8 +10,8 @@ module OCI
10
10
  DATABASE_EDITION_ENUM = [
11
11
  DATABASE_EDITION_STANDARD_EDITION = 'STANDARD_EDITION'.freeze,
12
12
  DATABASE_EDITION_ENTERPRISE_EDITION = 'ENTERPRISE_EDITION'.freeze,
13
- DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = 'ENTERPRISE_EDITION_EXTREME_PERFORMANCE'.freeze,
14
- DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = 'ENTERPRISE_EDITION_HIGH_PERFORMANCE'.freeze
13
+ DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = 'ENTERPRISE_EDITION_HIGH_PERFORMANCE'.freeze,
14
+ DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = 'ENTERPRISE_EDITION_EXTREME_PERFORMANCE'.freeze
15
15
  ].freeze
16
16
 
17
17
  DISK_REDUNDANCY_ENUM = [
@@ -24,8 +24,8 @@ module OCI
24
24
  LICENSE_MODEL_BRING_YOUR_OWN_LICENSE = 'BRING_YOUR_OWN_LICENSE'.freeze
25
25
  ].freeze
26
26
 
27
- # **[Required]** The Oracle Database Edition that applies to all the databases on the DB System.
28
- # Exadata DB Systems and 2-node RAC DB Systems require ENTERPRISE_EDITION_EXTREME_PERFORMANCE.
27
+ # **[Required]** The Oracle Database Edition that applies to all the databases on the DB system.
28
+ # Exadata DB systems and 2-node RAC DB systems require ENTERPRISE_EDITION_EXTREME_PERFORMANCE.
29
29
  #
30
30
  # @return [String]
31
31
  attr_reader :database_edition
@@ -34,14 +34,14 @@ module OCI
34
34
  # @return [OCI::Database::Models::CreateDbHomeDetails]
35
35
  attr_accessor :db_home
36
36
 
37
- # The type of redundancy configured for the DB System.
37
+ # The type of redundancy configured for the DB system.
38
38
  # Normal is 2-way redundancy, recommended for test and development systems.
39
39
  # High is 3-way redundancy, recommended for production systems.
40
40
  #
41
41
  # @return [String]
42
42
  attr_reader :disk_redundancy
43
43
 
44
- # The Oracle license model that applies to all the databases on the DB System. The default is BRING_YOUR_OWN_LICENSE.
44
+ # The Oracle license model that applies to all the databases on the DB system. The default is LICENSE_INCLUDED.
45
45
  #
46
46
  # @return [String]
47
47
  attr_reader :license_model