diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 59b4e83b2c..7a64dfff80 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -3,6 +3,25 @@ Change Log All notable changes to this project will be documented in this file. The format is based on `Keep a Changelog `_. +==================== +2.30.0 - 2021-02-02 +==================== + +Added +----- +* Support for checking if a contact for Exadata infrastructure is valid in My Oracle Support in the Database service +* Support for checking if Exadata infrastructure is in a degraded state in the Database service +* Support for updating the operating system on a VM cluster in the Database service +* Support for external databases in the Database service +* Support for uploading objects to the infrequent access storage tier in the Object Storage service +* Support for changing the storage tier of existing objects in the Object Storage service +* Support for private templates in the Resource Manager service +* Support for multiple encryption domains on IPSec tunnels in the Networking service + +Breaking +-------- +* Attribute `vnic_id` in response model `Ipv6` changed from required to optional in the Networking service + ==================== 2.29.0 - 2021-01-26 ==================== diff --git a/docs/api/core.rst b/docs/api/core.rst index 2b2e99a151..ba1f38651f 100644 --- a/docs/api/core.rst +++ b/docs/api/core.rst @@ -134,6 +134,7 @@ Core Services oci.core.models.CreateIPSecConnectionDetails oci.core.models.CreateIPSecConnectionTunnelDetails oci.core.models.CreateIPSecTunnelBgpSessionDetails + oci.core.models.CreateIPSecTunnelEncryptionDomainDetails oci.core.models.CreateImageDetails oci.core.models.CreateInstanceConfigurationBase oci.core.models.CreateInstanceConfigurationDetails @@ -188,6 +189,7 @@ Core Services oci.core.models.DrgRedundancyStatus oci.core.models.EgressSecurityRule oci.core.models.EmulatedVolumeAttachment + oci.core.models.EncryptionDomainConfig oci.core.models.EnumIntegerImageCapabilityDescriptor oci.core.models.EnumStringImageCapabilitySchemaDescriptor oci.core.models.ExportImageDetails @@ -316,6 +318,7 @@ Core Services oci.core.models.UpdateIPSecConnectionTunnelDetails oci.core.models.UpdateIPSecConnectionTunnelSharedSecretDetails oci.core.models.UpdateIPSecTunnelBgpSessionDetails + oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails oci.core.models.UpdateImageDetails oci.core.models.UpdateInstanceAgentConfigDetails oci.core.models.UpdateInstanceAvailabilityConfigDetails diff --git a/docs/api/core/models/oci.core.models.CreateIPSecTunnelEncryptionDomainDetails.rst b/docs/api/core/models/oci.core.models.CreateIPSecTunnelEncryptionDomainDetails.rst new file mode 100644 index 0000000000..eac2b6edb7 --- /dev/null +++ b/docs/api/core/models/oci.core.models.CreateIPSecTunnelEncryptionDomainDetails.rst @@ -0,0 +1,11 @@ +CreateIPSecTunnelEncryptionDomainDetails +======================================== + +.. currentmodule:: oci.core.models + +.. autoclass:: CreateIPSecTunnelEncryptionDomainDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/core/models/oci.core.models.EncryptionDomainConfig.rst b/docs/api/core/models/oci.core.models.EncryptionDomainConfig.rst new file mode 100644 index 0000000000..9e5eed665f --- /dev/null +++ b/docs/api/core/models/oci.core.models.EncryptionDomainConfig.rst @@ -0,0 +1,11 @@ +EncryptionDomainConfig +====================== + +.. currentmodule:: oci.core.models + +.. autoclass:: EncryptionDomainConfig + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/core/models/oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails.rst b/docs/api/core/models/oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails.rst new file mode 100644 index 0000000000..84cdbcf786 --- /dev/null +++ b/docs/api/core/models/oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails.rst @@ -0,0 +1,11 @@ +UpdateIPSecTunnelEncryptionDomainDetails +======================================== + +.. currentmodule:: oci.core.models + +.. autoclass:: UpdateIPSecTunnelEncryptionDomainDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database.rst b/docs/api/database.rst index 2a770d9649..23bfbf2811 100644 --- a/docs/api/database.rst +++ b/docs/api/database.rst @@ -105,6 +105,12 @@ Database oci.database.models.CreateDbHomeWithVmClusterIdFromBackupDetails oci.database.models.CreateExadataInfrastructureDetails oci.database.models.CreateExternalBackupJobDetails + oci.database.models.CreateExternalContainerDatabaseDetails + oci.database.models.CreateExternalDatabaseConnectorDetails + oci.database.models.CreateExternalDatabaseDetailsBase + oci.database.models.CreateExternalMacsConnectorDetails + oci.database.models.CreateExternalNonContainerDatabaseDetails + oci.database.models.CreateExternalPluggableDatabaseDetails oci.database.models.CreateKeyStoreDetails oci.database.models.CreateNFSBackupDestinationDetails oci.database.models.CreateNewDatabaseDetails @@ -114,7 +120,12 @@ Database oci.database.models.DataGuardAssociation oci.database.models.DataGuardAssociationSummary oci.database.models.Database + oci.database.models.DatabaseConnectionCredentailsByName + oci.database.models.DatabaseConnectionCredentials + oci.database.models.DatabaseConnectionCredentialsByDetails + oci.database.models.DatabaseConnectionString oci.database.models.DatabaseConnectionStrings + oci.database.models.DatabaseManagementConfig oci.database.models.DatabaseSoftwareImage oci.database.models.DatabaseSoftwareImageSummary oci.database.models.DatabaseSummary @@ -138,6 +149,10 @@ Database oci.database.models.DbSystemSummary oci.database.models.DbVersionSummary oci.database.models.DeregisterAutonomousDatabaseDataSafeDetails + oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails + oci.database.models.EnableExternalDatabaseManagementDetailsBase + oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails + oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails oci.database.models.ExadataDbSystemMigration oci.database.models.ExadataDbSystemMigrationSummary oci.database.models.ExadataInfrastructure @@ -146,6 +161,17 @@ Database oci.database.models.ExadataIormConfig oci.database.models.ExadataIormConfigUpdateDetails oci.database.models.ExternalBackupJob + oci.database.models.ExternalContainerDatabase + oci.database.models.ExternalContainerDatabaseSummary + oci.database.models.ExternalDatabaseBase + oci.database.models.ExternalDatabaseConnector + oci.database.models.ExternalDatabaseConnectorSummary + oci.database.models.ExternalMacsConnector + oci.database.models.ExternalMacsConnectorSummary + oci.database.models.ExternalNonContainerDatabase + oci.database.models.ExternalNonContainerDatabaseSummary + oci.database.models.ExternalPluggableDatabase + oci.database.models.ExternalPluggableDatabaseSummary oci.database.models.FailoverDataGuardAssociationDetails oci.database.models.FlexComponentCollection oci.database.models.FlexComponentSummary @@ -200,6 +226,12 @@ Database oci.database.models.UpdateDbSystemDetails oci.database.models.UpdateDetails oci.database.models.UpdateExadataInfrastructureDetails + oci.database.models.UpdateExternalContainerDatabaseDetails + oci.database.models.UpdateExternalDatabaseConnectorDetails + oci.database.models.UpdateExternalDatabaseDetailsBase + oci.database.models.UpdateExternalMacsConnectorDetails + oci.database.models.UpdateExternalNonContainerDatabaseDetails + oci.database.models.UpdateExternalPluggableDatabaseDetails oci.database.models.UpdateHistoryEntry oci.database.models.UpdateHistoryEntrySummary oci.database.models.UpdateKeyStoreDetails diff --git a/docs/api/database/models/oci.database.models.CreateExternalContainerDatabaseDetails.rst b/docs/api/database/models/oci.database.models.CreateExternalContainerDatabaseDetails.rst new file mode 100644 index 0000000000..b21f1eca96 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalContainerDatabaseDetails.rst @@ -0,0 +1,11 @@ +CreateExternalContainerDatabaseDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalContainerDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.CreateExternalDatabaseConnectorDetails.rst b/docs/api/database/models/oci.database.models.CreateExternalDatabaseConnectorDetails.rst new file mode 100644 index 0000000000..16a7ac0d1d --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalDatabaseConnectorDetails.rst @@ -0,0 +1,11 @@ +CreateExternalDatabaseConnectorDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalDatabaseConnectorDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.CreateExternalDatabaseDetailsBase.rst b/docs/api/database/models/oci.database.models.CreateExternalDatabaseDetailsBase.rst new file mode 100644 index 0000000000..28b915f40a --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalDatabaseDetailsBase.rst @@ -0,0 +1,11 @@ +CreateExternalDatabaseDetailsBase +================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalDatabaseDetailsBase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.CreateExternalMacsConnectorDetails.rst b/docs/api/database/models/oci.database.models.CreateExternalMacsConnectorDetails.rst new file mode 100644 index 0000000000..c5081a525f --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalMacsConnectorDetails.rst @@ -0,0 +1,11 @@ +CreateExternalMacsConnectorDetails +================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalMacsConnectorDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.CreateExternalNonContainerDatabaseDetails.rst b/docs/api/database/models/oci.database.models.CreateExternalNonContainerDatabaseDetails.rst new file mode 100644 index 0000000000..cd62912ae3 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalNonContainerDatabaseDetails.rst @@ -0,0 +1,11 @@ +CreateExternalNonContainerDatabaseDetails +========================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalNonContainerDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.CreateExternalPluggableDatabaseDetails.rst b/docs/api/database/models/oci.database.models.CreateExternalPluggableDatabaseDetails.rst new file mode 100644 index 0000000000..ad1d278e21 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExternalPluggableDatabaseDetails.rst @@ -0,0 +1,11 @@ +CreateExternalPluggableDatabaseDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExternalPluggableDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.DatabaseConnectionCredentailsByName.rst b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentailsByName.rst new file mode 100644 index 0000000000..253be3dac2 --- /dev/null +++ b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentailsByName.rst @@ -0,0 +1,11 @@ +DatabaseConnectionCredentailsByName +=================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: DatabaseConnectionCredentailsByName + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.DatabaseConnectionCredentials.rst b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentials.rst new file mode 100644 index 0000000000..02484a4b09 --- /dev/null +++ b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentials.rst @@ -0,0 +1,11 @@ +DatabaseConnectionCredentials +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: DatabaseConnectionCredentials + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.DatabaseConnectionCredentialsByDetails.rst b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentialsByDetails.rst new file mode 100644 index 0000000000..fb0277be0c --- /dev/null +++ b/docs/api/database/models/oci.database.models.DatabaseConnectionCredentialsByDetails.rst @@ -0,0 +1,11 @@ +DatabaseConnectionCredentialsByDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: DatabaseConnectionCredentialsByDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.DatabaseConnectionString.rst b/docs/api/database/models/oci.database.models.DatabaseConnectionString.rst new file mode 100644 index 0000000000..a995138beb --- /dev/null +++ b/docs/api/database/models/oci.database.models.DatabaseConnectionString.rst @@ -0,0 +1,11 @@ +DatabaseConnectionString +======================== + +.. currentmodule:: oci.database.models + +.. autoclass:: DatabaseConnectionString + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.DatabaseManagementConfig.rst b/docs/api/database/models/oci.database.models.DatabaseManagementConfig.rst new file mode 100644 index 0000000000..cbb9b459cc --- /dev/null +++ b/docs/api/database/models/oci.database.models.DatabaseManagementConfig.rst @@ -0,0 +1,11 @@ +DatabaseManagementConfig +======================== + +.. currentmodule:: oci.database.models + +.. autoclass:: DatabaseManagementConfig + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails.rst b/docs/api/database/models/oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails.rst new file mode 100644 index 0000000000..a2bea23db3 --- /dev/null +++ b/docs/api/database/models/oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails.rst @@ -0,0 +1,11 @@ +EnableExternalContainerDatabaseDatabaseManagementDetails +======================================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: EnableExternalContainerDatabaseDatabaseManagementDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.EnableExternalDatabaseManagementDetailsBase.rst b/docs/api/database/models/oci.database.models.EnableExternalDatabaseManagementDetailsBase.rst new file mode 100644 index 0000000000..ab9d65d498 --- /dev/null +++ b/docs/api/database/models/oci.database.models.EnableExternalDatabaseManagementDetailsBase.rst @@ -0,0 +1,11 @@ +EnableExternalDatabaseManagementDetailsBase +=========================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: EnableExternalDatabaseManagementDetailsBase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails.rst b/docs/api/database/models/oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails.rst new file mode 100644 index 0000000000..feb491b9a4 --- /dev/null +++ b/docs/api/database/models/oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails.rst @@ -0,0 +1,11 @@ +EnableExternalNonContainerDatabaseDatabaseManagementDetails +=========================================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: EnableExternalNonContainerDatabaseDatabaseManagementDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails.rst b/docs/api/database/models/oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails.rst new file mode 100644 index 0000000000..52f20b45a8 --- /dev/null +++ b/docs/api/database/models/oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails.rst @@ -0,0 +1,11 @@ +EnableExternalPluggableDatabaseDatabaseManagementDetails +======================================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: EnableExternalPluggableDatabaseDatabaseManagementDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalContainerDatabase.rst b/docs/api/database/models/oci.database.models.ExternalContainerDatabase.rst new file mode 100644 index 0000000000..2b2fcbf0b8 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalContainerDatabase.rst @@ -0,0 +1,11 @@ +ExternalContainerDatabase +========================= + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalContainerDatabase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalContainerDatabaseSummary.rst b/docs/api/database/models/oci.database.models.ExternalContainerDatabaseSummary.rst new file mode 100644 index 0000000000..28be749234 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalContainerDatabaseSummary.rst @@ -0,0 +1,11 @@ +ExternalContainerDatabaseSummary +================================ + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalContainerDatabaseSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalDatabaseBase.rst b/docs/api/database/models/oci.database.models.ExternalDatabaseBase.rst new file mode 100644 index 0000000000..1920d0e036 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalDatabaseBase.rst @@ -0,0 +1,11 @@ +ExternalDatabaseBase +==================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalDatabaseBase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalDatabaseConnector.rst b/docs/api/database/models/oci.database.models.ExternalDatabaseConnector.rst new file mode 100644 index 0000000000..08a4ad8d45 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalDatabaseConnector.rst @@ -0,0 +1,11 @@ +ExternalDatabaseConnector +========================= + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalDatabaseConnector + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalDatabaseConnectorSummary.rst b/docs/api/database/models/oci.database.models.ExternalDatabaseConnectorSummary.rst new file mode 100644 index 0000000000..67820dee3c --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalDatabaseConnectorSummary.rst @@ -0,0 +1,11 @@ +ExternalDatabaseConnectorSummary +================================ + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalDatabaseConnectorSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalMacsConnector.rst b/docs/api/database/models/oci.database.models.ExternalMacsConnector.rst new file mode 100644 index 0000000000..a0cd84f852 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalMacsConnector.rst @@ -0,0 +1,11 @@ +ExternalMacsConnector +===================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalMacsConnector + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalMacsConnectorSummary.rst b/docs/api/database/models/oci.database.models.ExternalMacsConnectorSummary.rst new file mode 100644 index 0000000000..d5acad3c93 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalMacsConnectorSummary.rst @@ -0,0 +1,11 @@ +ExternalMacsConnectorSummary +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalMacsConnectorSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalNonContainerDatabase.rst b/docs/api/database/models/oci.database.models.ExternalNonContainerDatabase.rst new file mode 100644 index 0000000000..96f2c5266c --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalNonContainerDatabase.rst @@ -0,0 +1,11 @@ +ExternalNonContainerDatabase +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalNonContainerDatabase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalNonContainerDatabaseSummary.rst b/docs/api/database/models/oci.database.models.ExternalNonContainerDatabaseSummary.rst new file mode 100644 index 0000000000..4966958abb --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalNonContainerDatabaseSummary.rst @@ -0,0 +1,11 @@ +ExternalNonContainerDatabaseSummary +=================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalNonContainerDatabaseSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalPluggableDatabase.rst b/docs/api/database/models/oci.database.models.ExternalPluggableDatabase.rst new file mode 100644 index 0000000000..caf5a9b5e8 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalPluggableDatabase.rst @@ -0,0 +1,11 @@ +ExternalPluggableDatabase +========================= + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalPluggableDatabase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.ExternalPluggableDatabaseSummary.rst b/docs/api/database/models/oci.database.models.ExternalPluggableDatabaseSummary.rst new file mode 100644 index 0000000000..efa1493c8d --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExternalPluggableDatabaseSummary.rst @@ -0,0 +1,11 @@ +ExternalPluggableDatabaseSummary +================================ + +.. currentmodule:: oci.database.models + +.. autoclass:: ExternalPluggableDatabaseSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalContainerDatabaseDetails.rst b/docs/api/database/models/oci.database.models.UpdateExternalContainerDatabaseDetails.rst new file mode 100644 index 0000000000..24c4624da3 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalContainerDatabaseDetails.rst @@ -0,0 +1,11 @@ +UpdateExternalContainerDatabaseDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalContainerDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalDatabaseConnectorDetails.rst b/docs/api/database/models/oci.database.models.UpdateExternalDatabaseConnectorDetails.rst new file mode 100644 index 0000000000..0265e303a5 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalDatabaseConnectorDetails.rst @@ -0,0 +1,11 @@ +UpdateExternalDatabaseConnectorDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalDatabaseConnectorDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalDatabaseDetailsBase.rst b/docs/api/database/models/oci.database.models.UpdateExternalDatabaseDetailsBase.rst new file mode 100644 index 0000000000..4c39c17516 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalDatabaseDetailsBase.rst @@ -0,0 +1,11 @@ +UpdateExternalDatabaseDetailsBase +================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalDatabaseDetailsBase + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalMacsConnectorDetails.rst b/docs/api/database/models/oci.database.models.UpdateExternalMacsConnectorDetails.rst new file mode 100644 index 0000000000..18cd9b4bea --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalMacsConnectorDetails.rst @@ -0,0 +1,11 @@ +UpdateExternalMacsConnectorDetails +================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalMacsConnectorDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalNonContainerDatabaseDetails.rst b/docs/api/database/models/oci.database.models.UpdateExternalNonContainerDatabaseDetails.rst new file mode 100644 index 0000000000..06a6a06580 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalNonContainerDatabaseDetails.rst @@ -0,0 +1,11 @@ +UpdateExternalNonContainerDatabaseDetails +========================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalNonContainerDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database/models/oci.database.models.UpdateExternalPluggableDatabaseDetails.rst b/docs/api/database/models/oci.database.models.UpdateExternalPluggableDatabaseDetails.rst new file mode 100644 index 0000000000..724a5effad --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExternalPluggableDatabaseDetails.rst @@ -0,0 +1,11 @@ +UpdateExternalPluggableDatabaseDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExternalPluggableDatabaseDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage.rst b/docs/api/object_storage.rst index 57e951b5c4..7dedb0d1f0 100644 --- a/docs/api/object_storage.rst +++ b/docs/api/object_storage.rst @@ -56,6 +56,7 @@ Object Storage oci.object_storage.models.SSECustomerKeyDetails oci.object_storage.models.UpdateBucketDetails oci.object_storage.models.UpdateNamespaceMetadataDetails + oci.object_storage.models.UpdateObjectStorageTierDetails oci.object_storage.models.UpdateRetentionRuleDetails oci.object_storage.models.WorkRequest oci.object_storage.models.WorkRequestError diff --git a/docs/api/object_storage/models/oci.object_storage.models.UpdateObjectStorageTierDetails.rst b/docs/api/object_storage/models/oci.object_storage.models.UpdateObjectStorageTierDetails.rst new file mode 100644 index 0000000000..211bf2ca62 --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.UpdateObjectStorageTierDetails.rst @@ -0,0 +1,11 @@ +UpdateObjectStorageTierDetails +============================== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: UpdateObjectStorageTierDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager.rst b/docs/api/resource_manager.rst index d6e79015db..7acd70e23e 100644 --- a/docs/api/resource_manager.rst +++ b/docs/api/resource_manager.rst @@ -23,6 +23,7 @@ Resource Manager oci.resource_manager.models.ApplyJobPlanResolution oci.resource_manager.models.ChangeConfigurationSourceProviderCompartmentDetails oci.resource_manager.models.ChangeStackCompartmentDetails + oci.resource_manager.models.ChangeTemplateCompartmentDetails oci.resource_manager.models.CompartmentConfigSource oci.resource_manager.models.ConfigSource oci.resource_manager.models.ConfigSourceRecord @@ -42,6 +43,10 @@ Resource Manager oci.resource_manager.models.CreateJobOperationDetails oci.resource_manager.models.CreatePlanJobOperationDetails oci.resource_manager.models.CreateStackDetails + oci.resource_manager.models.CreateStackTemplateConfigSourceDetails + oci.resource_manager.models.CreateTemplateConfigSourceDetails + oci.resource_manager.models.CreateTemplateDetails + oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails oci.resource_manager.models.CreateZipUploadConfigSourceDetails oci.resource_manager.models.DestroyJobOperationDetails oci.resource_manager.models.DestroyJobOperationDetailsSummary @@ -68,6 +73,13 @@ Resource Manager oci.resource_manager.models.StackResourceDriftCollection oci.resource_manager.models.StackResourceDriftSummary oci.resource_manager.models.StackSummary + oci.resource_manager.models.Template + oci.resource_manager.models.TemplateCategorySummary + oci.resource_manager.models.TemplateCategorySummaryCollection + oci.resource_manager.models.TemplateConfigSource + oci.resource_manager.models.TemplateSummary + oci.resource_manager.models.TemplateSummaryCollection + oci.resource_manager.models.TemplateZipUploadConfigSource oci.resource_manager.models.TerraformVersionCollection oci.resource_manager.models.TerraformVersionSummary oci.resource_manager.models.UpdateConfigSourceDetails @@ -77,6 +89,9 @@ Resource Manager oci.resource_manager.models.UpdateGitlabAccessTokenConfigurationSourceProviderDetails oci.resource_manager.models.UpdateJobDetails oci.resource_manager.models.UpdateStackDetails + oci.resource_manager.models.UpdateTemplateConfigSourceDetails + oci.resource_manager.models.UpdateTemplateDetails + oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails oci.resource_manager.models.UpdateZipUploadConfigSourceDetails oci.resource_manager.models.WorkRequest oci.resource_manager.models.WorkRequestError diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.ChangeTemplateCompartmentDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.ChangeTemplateCompartmentDetails.rst new file mode 100644 index 0000000000..5e4609ddbd --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.ChangeTemplateCompartmentDetails.rst @@ -0,0 +1,11 @@ +ChangeTemplateCompartmentDetails +================================ + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: ChangeTemplateCompartmentDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.CreateStackTemplateConfigSourceDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.CreateStackTemplateConfigSourceDetails.rst new file mode 100644 index 0000000000..6ffeacdf42 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.CreateStackTemplateConfigSourceDetails.rst @@ -0,0 +1,11 @@ +CreateStackTemplateConfigSourceDetails +====================================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: CreateStackTemplateConfigSourceDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateConfigSourceDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateConfigSourceDetails.rst new file mode 100644 index 0000000000..4d01f5ecaf --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateConfigSourceDetails.rst @@ -0,0 +1,11 @@ +CreateTemplateConfigSourceDetails +================================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: CreateTemplateConfigSourceDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateDetails.rst new file mode 100644 index 0000000000..da5ae986a8 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateDetails.rst @@ -0,0 +1,11 @@ +CreateTemplateDetails +===================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: CreateTemplateDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails.rst new file mode 100644 index 0000000000..0850e13879 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails.rst @@ -0,0 +1,11 @@ +CreateTemplateZipUploadConfigSourceDetails +========================================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: CreateTemplateZipUploadConfigSourceDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.Template.rst b/docs/api/resource_manager/models/oci.resource_manager.models.Template.rst new file mode 100644 index 0000000000..3e37f32737 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.Template.rst @@ -0,0 +1,11 @@ +Template +======== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: Template + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummary.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummary.rst new file mode 100644 index 0000000000..a521011d76 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummary.rst @@ -0,0 +1,11 @@ +TemplateCategorySummary +======================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateCategorySummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummaryCollection.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummaryCollection.rst new file mode 100644 index 0000000000..b6d9c5ffbb --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateCategorySummaryCollection.rst @@ -0,0 +1,11 @@ +TemplateCategorySummaryCollection +================================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateCategorySummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateConfigSource.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateConfigSource.rst new file mode 100644 index 0000000000..436f958922 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateConfigSource.rst @@ -0,0 +1,11 @@ +TemplateConfigSource +==================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateConfigSource + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummary.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummary.rst new file mode 100644 index 0000000000..01f202d24c --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummary.rst @@ -0,0 +1,11 @@ +TemplateSummary +=============== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummaryCollection.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummaryCollection.rst new file mode 100644 index 0000000000..5abea62445 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateSummaryCollection.rst @@ -0,0 +1,11 @@ +TemplateSummaryCollection +========================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.TemplateZipUploadConfigSource.rst b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateZipUploadConfigSource.rst new file mode 100644 index 0000000000..bb6f7acbbe --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.TemplateZipUploadConfigSource.rst @@ -0,0 +1,11 @@ +TemplateZipUploadConfigSource +============================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: TemplateZipUploadConfigSource + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateConfigSourceDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateConfigSourceDetails.rst new file mode 100644 index 0000000000..04e8f76bba --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateConfigSourceDetails.rst @@ -0,0 +1,11 @@ +UpdateTemplateConfigSourceDetails +================================= + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: UpdateTemplateConfigSourceDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateDetails.rst new file mode 100644 index 0000000000..c9e357d222 --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateDetails.rst @@ -0,0 +1,11 @@ +UpdateTemplateDetails +===================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: UpdateTemplateDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails.rst b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails.rst new file mode 100644 index 0000000000..7fc81a5fbb --- /dev/null +++ b/docs/api/resource_manager/models/oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails.rst @@ -0,0 +1,11 @@ +UpdateTemplateZipUploadConfigSourceDetails +========================================== + +.. currentmodule:: oci.resource_manager.models + +.. autoclass:: UpdateTemplateZipUploadConfigSourceDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/src/oci/core/blockstorage_client.py b/src/oci/core/blockstorage_client.py index 14d4461ef3..7e90fda72a 100644 --- a/src/oci/core/blockstorage_client.py +++ b/src/oci/core/blockstorage_client.py @@ -1407,7 +1407,7 @@ def delete_boot_volume(self, boot_volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1482,7 +1482,7 @@ def delete_boot_volume_backup(self, boot_volume_backup_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1557,7 +1557,7 @@ def delete_boot_volume_kms_key(self, boot_volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1637,7 +1637,7 @@ def delete_volume(self, volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1712,7 +1712,7 @@ def delete_volume_backup(self, volume_backup_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1797,7 +1797,7 @@ def delete_volume_backup_policy(self, policy_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1874,7 +1874,7 @@ def delete_volume_backup_policy_assignment(self, policy_assignment_id, **kwargs) :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1952,7 +1952,7 @@ def delete_volume_group(self, volume_group_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2019,7 +2019,8 @@ def delete_volume_group(self, volume_group_id, **kwargs): def delete_volume_group_backup(self, volume_group_backup_id, **kwargs): """ - Deletes a volume group backup. This operation deletes all the backups in the volume group. For more information, see `Volume Groups`__. + Deletes a volume group backup. This operation deletes all the backups in + the volume group. For more information, see `Volume Groups`__. __ https://docs.cloud.oracle.com/Content/Block/Concepts/volumegroups.htm @@ -2029,7 +2030,7 @@ def delete_volume_group_backup(self, volume_group_backup_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2104,7 +2105,7 @@ def delete_volume_kms_key(self, volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2311,7 +2312,7 @@ def get_boot_volume_kms_key(self, boot_volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2874,7 +2875,7 @@ def get_volume_kms_key(self, volume_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2995,7 +2996,8 @@ def list_boot_volume_backups(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state value is + case-insensitive. Allowed values are: "CREATING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY", "REQUEST_RECEIVED" @@ -3334,7 +3336,8 @@ def list_volume_backups(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "CREATING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY", "REQUEST_RECEIVED" @@ -3622,7 +3625,8 @@ def list_volume_groups(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY" @@ -3773,7 +3777,8 @@ def list_volumes(self, compartment_id, **kwargs): The OCID of the volume group. :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "PROVISIONING", "RESTORING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAULTY" @@ -3883,7 +3888,7 @@ def update_boot_volume(self, boot_volume_id, update_boot_volume_details, **kwarg :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -3966,7 +3971,7 @@ def update_boot_volume_backup(self, boot_volume_backup_id, update_boot_volume_ba :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4048,7 +4053,7 @@ def update_boot_volume_kms_key(self, boot_volume_id, update_boot_volume_kms_key_ :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4131,7 +4136,7 @@ def update_volume(self, volume_id, update_volume_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4214,7 +4219,7 @@ def update_volume_backup(self, volume_backup_id, update_volume_backup_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4302,7 +4307,7 @@ def update_volume_backup_policy(self, policy_id, update_volume_backup_policy_det :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -4408,7 +4413,7 @@ def update_volume_group(self, volume_group_id, update_volume_group_details, **kw :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4492,7 +4497,7 @@ def update_volume_group_backup(self, volume_group_backup_id, update_volume_group :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4574,7 +4579,7 @@ def update_volume_kms_key(self, volume_id, update_volume_kms_key_details, **kwar :param str if_match: (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 + 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. :param obj retry_strategy: (optional) diff --git a/src/oci/core/compute_client.py b/src/oci/core/compute_client.py index 2dccf1af9f..8bb49286f8 100644 --- a/src/oci/core/compute_client.py +++ b/src/oci/core/compute_client.py @@ -493,7 +493,7 @@ def change_compute_image_capability_schema_compartment(self, compute_image_capab :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -590,7 +590,7 @@ def change_dedicated_vm_host_compartment(self, dedicated_vm_host_id, change_dedi :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -693,7 +693,7 @@ def change_image_compartment(self, image_id, change_image_compartment_details, * :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -797,7 +797,7 @@ def change_instance_compartment(self, instance_id, change_instance_compartment_d :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -1209,7 +1209,7 @@ def create_instance_console_connection(self, create_instance_console_connection_ After the console connection has been created and is available, you connect to the console using SSH. - For more information about console access, see `Accessing the Console`__. + For more information about instance console connections, see `Troubleshooting Instances Using Instance Console Connections`__. __ https://docs.cloud.oracle.com/Content/Compute/References/serialconsole.htm @@ -1359,7 +1359,7 @@ def delete_compute_image_capability_schema(self, compute_image_capability_schema :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1434,7 +1434,7 @@ def delete_console_history(self, instance_console_history_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1588,7 +1588,7 @@ def delete_image(self, image_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1663,7 +1663,7 @@ def delete_instance_console_connection(self, instance_console_connection_id, **k :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1741,7 +1741,7 @@ def detach_boot_volume(self, boot_volume_attachment_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1827,7 +1827,7 @@ def detach_vnic(self, vnic_attachment_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1905,7 +1905,7 @@ def detach_volume(self, volume_attachment_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2006,7 +2006,7 @@ def export_image(self, image_id, export_image_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -3294,12 +3294,14 @@ def instance_action(self, instance_id, action, **kwargs): - **RESET** - Powers off the instance and then powers it back on. - **SOFTSTOP** - Gracefully shuts down the instance by sending a shutdown command to the operating system. - If the applications that run on the instance take a long time to shut down, they could be improperly stopped, resulting - in data corruption. To avoid this, shut down the instance using the commands available in the OS before you softstop the + After waiting 15 minutes for the OS to shut down, the instance is powered off. + If the applications that run on the instance take more than 15 minutes to shut down, they could be improperly stopped, resulting + in data corruption. To avoid this, manually shut down the instance using the commands available in the OS before you softstop the instance. - - **SOFTRESET** - Gracefully reboots the instance by sending a shutdown command to the operating system, and - then powers the instance back on. + - **SOFTRESET** - Gracefully reboots the instance by sending a shutdown command to the operating system. + After waiting 15 minutes for the OS to shut down, the instance is powered off and + then powered back on. - **SENDDIAGNOSTICINTERRUPT** - For advanced users. **Warning: Sending a diagnostic interrupt to a live system can cause data corruption or system failure.** Sends a diagnostic interrupt that causes the instance's @@ -3308,6 +3310,7 @@ def instance_action(self, instance_id, action, **kwargs): the crash. After the OS restarts, you can analyze the crash dump to diagnose the issue. For more information, see `Sending a Diagnostic Interrupt`__. + For more information about managing instance lifecycle states, see `Stopping and Starting an Instance`__. @@ -3332,7 +3335,7 @@ def instance_action(self, instance_id, action, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4424,7 +4427,8 @@ def list_console_histories(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "REQUESTED", "GETTING-HISTORY", "SUCCEEDED", "FAILED" @@ -5218,7 +5222,8 @@ def list_images(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "PROVISIONING", "IMPORTING", "AVAILABLE", "EXPORTING", "DISABLED", "DELETED" @@ -5321,7 +5326,7 @@ def list_instance_console_connections(self, compartment_id, **kwargs): """ Lists the console connections for the specified compartment or instance. - For more information about console access, see `Accessing the Console`__. + For more information about instance console connections, see `Troubleshooting Instances Using Instance Console Connections`__. __ https://docs.cloud.oracle.com/Content/Compute/References/serialconsole.htm @@ -5615,7 +5620,8 @@ def list_instances(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "MOVING", "PROVISIONING", "RUNNING", "STARTING", "STOPPING", "STOPPED", "CREATING_IMAGE", "TERMINATING", "TERMINATED" @@ -6110,7 +6116,7 @@ def terminate_instance(self, instance_id, **kwargs): :param str if_match: (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 + 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. :param bool preserve_boot_volume: (optional) @@ -6200,7 +6206,7 @@ def update_compute_image_capability_schema(self, compute_image_capability_schema :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6282,7 +6288,7 @@ def update_console_history(self, instance_console_history_id, update_console_his :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6365,7 +6371,7 @@ def update_dedicated_vm_host(self, dedicated_vm_host_id, update_dedicated_vm_hos :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -6473,7 +6479,7 @@ def update_image(self, image_id, update_image_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6572,7 +6578,7 @@ def update_instance(self, instance_id, update_instance_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6662,7 +6668,7 @@ def update_instance_console_connection(self, instance_console_connection_id, upd :param str if_match: (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 + 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. :param obj retry_strategy: (optional) diff --git a/src/oci/core/compute_management_client.py b/src/oci/core/compute_management_client.py index 8541cb56a1..10cdcd1f43 100644 --- a/src/oci/core/compute_management_client.py +++ b/src/oci/core/compute_management_client.py @@ -113,7 +113,7 @@ def attach_load_balancer(self, instance_pool_id, attach_load_balancer_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -208,7 +208,7 @@ def change_cluster_network_compartment(self, cluster_network_id, change_cluster_ :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -320,7 +320,7 @@ def change_instance_configuration_compartment(self, instance_configuration_id, c :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -426,7 +426,7 @@ def change_instance_pool_compartment(self, instance_pool_id, change_instance_poo :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -737,7 +737,7 @@ def delete_instance_configuration(self, instance_configuration_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -824,7 +824,7 @@ def detach_load_balancer(self, instance_pool_id, detach_load_balancer_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -1863,7 +1863,8 @@ def list_instance_pools(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle state. The state + value is case-insensitive. Allowed values are: "PROVISIONING", "SCALING", "STARTING", "STOPPING", "TERMINATING", "STOPPED", "TERMINATED", "RUNNING" @@ -1958,7 +1959,7 @@ def list_instance_pools(self, compartment_id, **kwargs): def reset_instance_pool(self, instance_pool_id, **kwargs): """ - Performs the reset (power off and power on) action on the specified instance pool, + Performs the reset (immediate power off and power on) action on the specified instance pool, which performs the action on all the instances in the pool. @@ -1976,7 +1977,7 @@ def reset_instance_pool(self, instance_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2052,6 +2053,9 @@ def softreset_instance_pool(self, instance_pool_id, **kwargs): Performs the softreset (ACPI shutdown and power on) action on the specified instance pool, which performs the action on all the instances in the pool. + Softreset gracefully reboots the instances by sending a shutdown command to the operating systems. + After waiting 15 minutes for the OS to shut down, the instances are powered off and then powered back on. + :param str instance_pool_id: (required) The `OCID`__ of the instance pool. @@ -2067,7 +2071,7 @@ def softreset_instance_pool(self, instance_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2158,7 +2162,7 @@ def start_instance_pool(self, instance_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2231,7 +2235,7 @@ def start_instance_pool(self, instance_pool_id, **kwargs): def stop_instance_pool(self, instance_pool_id, **kwargs): """ - Performs the stop (power off) action on the specified instance pool, + Performs the stop (immediate power off) action on the specified instance pool, which performs the action on all the instances in the pool. @@ -2249,7 +2253,7 @@ def stop_instance_pool(self, instance_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2335,7 +2339,7 @@ def terminate_cluster_network(self, cluster_network_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2419,7 +2423,7 @@ def terminate_instance_pool(self, instance_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2506,7 +2510,7 @@ def update_cluster_network(self, cluster_network_id, update_cluster_network_deta :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2599,7 +2603,7 @@ def update_instance_configuration(self, instance_configuration_id, update_instan :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2696,7 +2700,7 @@ def update_instance_pool(self, instance_pool_id, update_instance_pool_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) diff --git a/src/oci/core/models/__init__.py b/src/oci/core/models/__init__.py index 26a7d2e86f..3b31418750 100644 --- a/src/oci/core/models/__init__.py +++ b/src/oci/core/models/__init__.py @@ -114,6 +114,7 @@ from .create_ip_sec_connection_details import CreateIPSecConnectionDetails from .create_ip_sec_connection_tunnel_details import CreateIPSecConnectionTunnelDetails from .create_ip_sec_tunnel_bgp_session_details import CreateIPSecTunnelBgpSessionDetails +from .create_ip_sec_tunnel_encryption_domain_details import CreateIPSecTunnelEncryptionDomainDetails from .create_image_details import CreateImageDetails from .create_instance_configuration_base import CreateInstanceConfigurationBase from .create_instance_configuration_details import CreateInstanceConfigurationDetails @@ -168,6 +169,7 @@ from .drg_redundancy_status import DrgRedundancyStatus from .egress_security_rule import EgressSecurityRule from .emulated_volume_attachment import EmulatedVolumeAttachment +from .encryption_domain_config import EncryptionDomainConfig from .enum_integer_image_capability_descriptor import EnumIntegerImageCapabilityDescriptor from .enum_string_image_capability_schema_descriptor import EnumStringImageCapabilitySchemaDescriptor from .export_image_details import ExportImageDetails @@ -296,6 +298,7 @@ from .update_ip_sec_connection_tunnel_details import UpdateIPSecConnectionTunnelDetails from .update_ip_sec_connection_tunnel_shared_secret_details import UpdateIPSecConnectionTunnelSharedSecretDetails from .update_ip_sec_tunnel_bgp_session_details import UpdateIPSecTunnelBgpSessionDetails +from .update_ip_sec_tunnel_encryption_domain_details import UpdateIPSecTunnelEncryptionDomainDetails from .update_image_details import UpdateImageDetails from .update_instance_agent_config_details import UpdateInstanceAgentConfigDetails from .update_instance_availability_config_details import UpdateInstanceAvailabilityConfigDetails @@ -470,6 +473,7 @@ "CreateIPSecConnectionDetails": CreateIPSecConnectionDetails, "CreateIPSecConnectionTunnelDetails": CreateIPSecConnectionTunnelDetails, "CreateIPSecTunnelBgpSessionDetails": CreateIPSecTunnelBgpSessionDetails, + "CreateIPSecTunnelEncryptionDomainDetails": CreateIPSecTunnelEncryptionDomainDetails, "CreateImageDetails": CreateImageDetails, "CreateInstanceConfigurationBase": CreateInstanceConfigurationBase, "CreateInstanceConfigurationDetails": CreateInstanceConfigurationDetails, @@ -524,6 +528,7 @@ "DrgRedundancyStatus": DrgRedundancyStatus, "EgressSecurityRule": EgressSecurityRule, "EmulatedVolumeAttachment": EmulatedVolumeAttachment, + "EncryptionDomainConfig": EncryptionDomainConfig, "EnumIntegerImageCapabilityDescriptor": EnumIntegerImageCapabilityDescriptor, "EnumStringImageCapabilitySchemaDescriptor": EnumStringImageCapabilitySchemaDescriptor, "ExportImageDetails": ExportImageDetails, @@ -652,6 +657,7 @@ "UpdateIPSecConnectionTunnelDetails": UpdateIPSecConnectionTunnelDetails, "UpdateIPSecConnectionTunnelSharedSecretDetails": UpdateIPSecConnectionTunnelSharedSecretDetails, "UpdateIPSecTunnelBgpSessionDetails": UpdateIPSecTunnelBgpSessionDetails, + "UpdateIPSecTunnelEncryptionDomainDetails": UpdateIPSecTunnelEncryptionDomainDetails, "UpdateImageDetails": UpdateImageDetails, "UpdateInstanceAgentConfigDetails": UpdateInstanceAgentConfigDetails, "UpdateInstanceAvailabilityConfigDetails": UpdateInstanceAvailabilityConfigDetails, diff --git a/src/oci/core/models/add_security_rule_details.py b/src/oci/core/models/add_security_rule_details.py index c5c5e6b888..845ea6f036 100644 --- a/src/oci/core/models/add_security_rule_details.py +++ b/src/oci/core/models/add_security_rule_details.py @@ -278,7 +278,8 @@ def destination_type(self, destination_type): def direction(self): """ **[Required]** Gets the direction of this AddSecurityRuleDetails. - Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, or `INGRESS` for rules to allow inbound IP packets. + Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, + or `INGRESS` for rules to allow inbound IP packets. Allowed values for this property are: "EGRESS", "INGRESS" @@ -292,7 +293,8 @@ def direction(self): def direction(self, direction): """ Sets the direction of this AddSecurityRuleDetails. - Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, or `INGRESS` for rules to allow inbound IP packets. + Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, + or `INGRESS` for rules to allow inbound IP packets. :param direction: The direction of this AddSecurityRuleDetails. diff --git a/src/oci/core/models/attach_load_balancer_details.py b/src/oci/core/models/attach_load_balancer_details.py index 8cf85399fb..86d647bc93 100644 --- a/src/oci/core/models/attach_load_balancer_details.py +++ b/src/oci/core/models/attach_load_balancer_details.py @@ -134,7 +134,9 @@ def port(self, port): def vnic_selection(self): """ **[Required]** Gets the vnic_selection of this AttachLoadBalancerDetails. - Indicates which VNIC on each instance in the pool should be used to associate with the load balancer. Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool. + Indicates which VNIC on each instance in the pool should be used to associate with the load balancer. + Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration + that is associated with the instance pool. :return: The vnic_selection of this AttachLoadBalancerDetails. @@ -146,7 +148,9 @@ def vnic_selection(self): def vnic_selection(self, vnic_selection): """ Sets the vnic_selection of this AttachLoadBalancerDetails. - Indicates which VNIC on each instance in the pool should be used to associate with the load balancer. Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool. + Indicates which VNIC on each instance in the pool should be used to associate with the load balancer. + Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration + that is associated with the instance pool. :param vnic_selection: The vnic_selection of this AttachLoadBalancerDetails. diff --git a/src/oci/core/models/boot_volume.py b/src/oci/core/models/boot_volume.py index e3fd6a48e4..cb200b0cf7 100644 --- a/src/oci/core/models/boot_volume.py +++ b/src/oci/core/models/boot_volume.py @@ -420,7 +420,8 @@ def image_id(self, image_id): def is_hydrated(self): """ Gets the is_hydrated of this BootVolume. - Specifies whether the boot volume's data has finished copying from the source boot volume or boot volume backup. + Specifies whether the boot volume's data has finished copying + from the source boot volume or boot volume backup. :return: The is_hydrated of this BootVolume. @@ -432,7 +433,8 @@ def is_hydrated(self): def is_hydrated(self, is_hydrated): """ Sets the is_hydrated of this BootVolume. - Specifies whether the boot volume's data has finished copying from the source boot volume or boot volume backup. + Specifies whether the boot volume's data has finished copying + from the source boot volume or boot volume backup. :param is_hydrated: The is_hydrated of this BootVolume. diff --git a/src/oci/core/models/cpe.py b/src/oci/core/models/cpe.py index 8bd85b0da5..55677d35d7 100644 --- a/src/oci/core/models/cpe.py +++ b/src/oci/core/models/cpe.py @@ -20,9 +20,6 @@ class Cpe(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/cpe_device_config_question.py b/src/oci/core/models/cpe_device_config_question.py index a3d1091321..f3e216404a 100644 --- a/src/oci/core/models/cpe_device_config_question.py +++ b/src/oci/core/models/cpe_device_config_question.py @@ -79,6 +79,7 @@ def display_name(self): """ Gets the display_name of this CpeDeviceConfigQuestion. A descriptive label for the question (for example, to display in a form in a graphical interface). + Avoid entering confidential information. :return: The display_name of this CpeDeviceConfigQuestion. @@ -91,6 +92,7 @@ def display_name(self, display_name): """ Sets the display_name of this CpeDeviceConfigQuestion. A descriptive label for the question (for example, to display in a form in a graphical interface). + Avoid entering confidential information. :param display_name: The display_name of this CpeDeviceConfigQuestion. diff --git a/src/oci/core/models/create_cluster_network_instance_pool_details.py b/src/oci/core/models/create_cluster_network_instance_pool_details.py index 10f729fd83..eabdea8851 100644 --- a/src/oci/core/models/create_cluster_network_instance_pool_details.py +++ b/src/oci/core/models/create_cluster_network_instance_pool_details.py @@ -189,12 +189,6 @@ def size(self): **[Required]** Gets the size of this CreateClusterNetworkInstancePoolDetails. The number of instances that should be in the instance pool. - For cluster networks with 10 or more instances, the cluster network is created if the required - number of instances is available and at least 95% of the instances in the pool launch - successfully. For cluster networks with less than 10 instances, all instances in the pool must - launch successfully. If the cluster network fails to launch, wait a few minutes, and then try - creating it again. - :return: The size of this CreateClusterNetworkInstancePoolDetails. :rtype: int @@ -207,12 +201,6 @@ def size(self, size): Sets the size of this CreateClusterNetworkInstancePoolDetails. The number of instances that should be in the instance pool. - For cluster networks with 10 or more instances, the cluster network is created if the required - number of instances is available and at least 95% of the instances in the pool launch - successfully. For cluster networks with less than 10 instances, all instances in the pool must - launch successfully. If the cluster network fails to launch, wait a few minutes, and then try - creating it again. - :param size: The size of this CreateClusterNetworkInstancePoolDetails. :type: int diff --git a/src/oci/core/models/create_cpe_details.py b/src/oci/core/models/create_cpe_details.py index 99201355c5..4a7faffef1 100644 --- a/src/oci/core/models/create_cpe_details.py +++ b/src/oci/core/models/create_cpe_details.py @@ -130,7 +130,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateCpeDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateCpeDetails. @@ -142,7 +143,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateCpeDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateCpeDetails. diff --git a/src/oci/core/models/create_dhcp_details.py b/src/oci/core/models/create_dhcp_details.py index bbf6e6dddd..8a4fc30a48 100644 --- a/src/oci/core/models/create_dhcp_details.py +++ b/src/oci/core/models/create_dhcp_details.py @@ -130,7 +130,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateDhcpDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateDhcpDetails. @@ -142,7 +143,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateDhcpDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateDhcpDetails. diff --git a/src/oci/core/models/create_drg_attachment_details.py b/src/oci/core/models/create_drg_attachment_details.py index 3bfa7d75c6..60b57e2b54 100644 --- a/src/oci/core/models/create_drg_attachment_details.py +++ b/src/oci/core/models/create_drg_attachment_details.py @@ -58,7 +58,8 @@ def __init__(self, **kwargs): def display_name(self): """ Gets the display_name of this CreateDrgAttachmentDetails. - A user-friendly name. Does not have to be unique. Avoid entering confidential information. + A user-friendly name. Does not have to be unique. Avoid entering + confidential information. :return: The display_name of this CreateDrgAttachmentDetails. @@ -70,7 +71,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateDrgAttachmentDetails. - A user-friendly name. Does not have to be unique. Avoid entering confidential information. + A user-friendly name. Does not have to be unique. Avoid entering + confidential information. :param display_name: The display_name of this CreateDrgAttachmentDetails. diff --git a/src/oci/core/models/create_drg_details.py b/src/oci/core/models/create_drg_details.py index 313b3bc4b6..f61b118e83 100644 --- a/src/oci/core/models/create_drg_details.py +++ b/src/oci/core/models/create_drg_details.py @@ -116,7 +116,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateDrgDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateDrgDetails. @@ -128,7 +129,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateDrgDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateDrgDetails. diff --git a/src/oci/core/models/create_instance_configuration_base.py b/src/oci/core/models/create_instance_configuration_base.py index 10cfe410d0..5a3811deac 100644 --- a/src/oci/core/models/create_instance_configuration_base.py +++ b/src/oci/core/models/create_instance_configuration_base.py @@ -159,7 +159,7 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateInstanceConfigurationBase. - A user-friendly name for the instance configuration. Does not have to be unique, + A user-friendly name for the instance configuration. Does not have to be unique, and it's changeable. Avoid entering confidential information. @@ -172,7 +172,7 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateInstanceConfigurationBase. - A user-friendly name for the instance configuration. Does not have to be unique, + A user-friendly name for the instance configuration. Does not have to be unique, and it's changeable. Avoid entering confidential information. diff --git a/src/oci/core/models/create_internet_gateway_details.py b/src/oci/core/models/create_internet_gateway_details.py index bd60482eb2..41bae8fe66 100644 --- a/src/oci/core/models/create_internet_gateway_details.py +++ b/src/oci/core/models/create_internet_gateway_details.py @@ -130,7 +130,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateInternetGatewayDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateInternetGatewayDetails. @@ -142,7 +143,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateInternetGatewayDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateInternetGatewayDetails. diff --git a/src/oci/core/models/create_ip_sec_connection_details.py b/src/oci/core/models/create_ip_sec_connection_details.py index 52f6a57bf1..4ee7d99a9f 100644 --- a/src/oci/core/models/create_ip_sec_connection_details.py +++ b/src/oci/core/models/create_ip_sec_connection_details.py @@ -191,7 +191,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateIPSecConnectionDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateIPSecConnectionDetails. @@ -203,7 +204,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateIPSecConnectionDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateIPSecConnectionDetails. diff --git a/src/oci/core/models/create_ip_sec_connection_tunnel_details.py b/src/oci/core/models/create_ip_sec_connection_tunnel_details.py index 4f6ea93ccd..07d73a9883 100644 --- a/src/oci/core/models/create_ip_sec_connection_tunnel_details.py +++ b/src/oci/core/models/create_ip_sec_connection_tunnel_details.py @@ -21,6 +21,10 @@ class CreateIPSecConnectionTunnelDetails(object): #: This constant has a value of "STATIC" ROUTING_STATIC = "STATIC" + #: A constant which can be used with the routing property of a CreateIPSecConnectionTunnelDetails. + #: This constant has a value of "POLICY" + ROUTING_POLICY = "POLICY" + #: A constant which can be used with the ike_version property of a CreateIPSecConnectionTunnelDetails. #: This constant has a value of "V1" IKE_VERSION_V1 = "V1" @@ -40,7 +44,7 @@ def __init__(self, **kwargs): :param routing: The value to assign to the routing property of this CreateIPSecConnectionTunnelDetails. - Allowed values for this property are: "BGP", "STATIC" + Allowed values for this property are: "BGP", "STATIC", "POLICY" :type routing: str :param ike_version: @@ -56,13 +60,18 @@ def __init__(self, **kwargs): The value to assign to the bgp_session_config property of this CreateIPSecConnectionTunnelDetails. :type bgp_session_config: oci.core.models.CreateIPSecTunnelBgpSessionDetails + :param encryption_domain_config: + The value to assign to the encryption_domain_config property of this CreateIPSecConnectionTunnelDetails. + :type encryption_domain_config: oci.core.models.CreateIPSecTunnelEncryptionDomainDetails + """ self.swagger_types = { 'display_name': 'str', 'routing': 'str', 'ike_version': 'str', 'shared_secret': 'str', - 'bgp_session_config': 'CreateIPSecTunnelBgpSessionDetails' + 'bgp_session_config': 'CreateIPSecTunnelBgpSessionDetails', + 'encryption_domain_config': 'CreateIPSecTunnelEncryptionDomainDetails' } self.attribute_map = { @@ -70,7 +79,8 @@ def __init__(self, **kwargs): 'routing': 'routing', 'ike_version': 'ikeVersion', 'shared_secret': 'sharedSecret', - 'bgp_session_config': 'bgpSessionConfig' + 'bgp_session_config': 'bgpSessionConfig', + 'encryption_domain_config': 'encryptionDomainConfig' } self._display_name = None @@ -78,6 +88,7 @@ def __init__(self, **kwargs): self._ike_version = None self._shared_secret = None self._bgp_session_config = None + self._encryption_domain_config = None @property def display_name(self): @@ -111,7 +122,7 @@ def routing(self): Gets the routing of this CreateIPSecConnectionTunnelDetails. The type of routing to use for this tunnel (either BGP dynamic routing or static routing). - Allowed values for this property are: "BGP", "STATIC" + Allowed values for this property are: "BGP", "STATIC", "POLICY" :return: The routing of this CreateIPSecConnectionTunnelDetails. @@ -129,7 +140,7 @@ def routing(self, routing): :param routing: The routing of this CreateIPSecConnectionTunnelDetails. :type: str """ - allowed_values = ["BGP", "STATIC"] + allowed_values = ["BGP", "STATIC", "POLICY"] if not value_allowed_none_or_none_sentinel(routing, allowed_values): raise ValueError( "Invalid value for `routing`, must be None or one of {0}" @@ -219,6 +230,26 @@ def bgp_session_config(self, bgp_session_config): """ self._bgp_session_config = bgp_session_config + @property + def encryption_domain_config(self): + """ + Gets the encryption_domain_config of this CreateIPSecConnectionTunnelDetails. + + :return: The encryption_domain_config of this CreateIPSecConnectionTunnelDetails. + :rtype: oci.core.models.CreateIPSecTunnelEncryptionDomainDetails + """ + return self._encryption_domain_config + + @encryption_domain_config.setter + def encryption_domain_config(self, encryption_domain_config): + """ + Sets the encryption_domain_config of this CreateIPSecConnectionTunnelDetails. + + :param encryption_domain_config: The encryption_domain_config of this CreateIPSecConnectionTunnelDetails. + :type: oci.core.models.CreateIPSecTunnelEncryptionDomainDetails + """ + self._encryption_domain_config = encryption_domain_config + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/core/models/create_ip_sec_tunnel_encryption_domain_details.py b/src/oci/core/models/create_ip_sec_tunnel_encryption_domain_details.py new file mode 100644 index 0000000000..91f2fd6f66 --- /dev/null +++ b/src/oci/core/models/create_ip_sec_tunnel_encryption_domain_details.py @@ -0,0 +1,102 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateIPSecTunnelEncryptionDomainDetails(object): + """ + Request to enable a multi-encryption domain policy on the VPNaaS tunnel. + The cross product of oracleTrafficSelector and cpeTrafficSelector can't be more than 50. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateIPSecTunnelEncryptionDomainDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param oracle_traffic_selector: + The value to assign to the oracle_traffic_selector property of this CreateIPSecTunnelEncryptionDomainDetails. + :type oracle_traffic_selector: list[str] + + :param cpe_traffic_selector: + The value to assign to the cpe_traffic_selector property of this CreateIPSecTunnelEncryptionDomainDetails. + :type cpe_traffic_selector: list[str] + + """ + self.swagger_types = { + 'oracle_traffic_selector': 'list[str]', + 'cpe_traffic_selector': 'list[str]' + } + + self.attribute_map = { + 'oracle_traffic_selector': 'oracleTrafficSelector', + 'cpe_traffic_selector': 'cpeTrafficSelector' + } + + self._oracle_traffic_selector = None + self._cpe_traffic_selector = None + + @property + def oracle_traffic_selector(self): + """ + Gets the oracle_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :return: The oracle_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + :rtype: list[str] + """ + return self._oracle_traffic_selector + + @oracle_traffic_selector.setter + def oracle_traffic_selector(self, oracle_traffic_selector): + """ + Sets the oracle_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :param oracle_traffic_selector: The oracle_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + :type: list[str] + """ + self._oracle_traffic_selector = oracle_traffic_selector + + @property + def cpe_traffic_selector(self): + """ + Gets the cpe_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :return: The cpe_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + :rtype: list[str] + """ + return self._cpe_traffic_selector + + @cpe_traffic_selector.setter + def cpe_traffic_selector(self, cpe_traffic_selector): + """ + Sets the cpe_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :param cpe_traffic_selector: The cpe_traffic_selector of this CreateIPSecTunnelEncryptionDomainDetails. + :type: list[str] + """ + self._cpe_traffic_selector = cpe_traffic_selector + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/core/models/create_ipv6_details.py b/src/oci/core/models/create_ipv6_details.py index 1d351f15e0..c402348fda 100644 --- a/src/oci/core/models/create_ipv6_details.py +++ b/src/oci/core/models/create_ipv6_details.py @@ -237,7 +237,7 @@ def is_internet_access_allowed(self, is_internet_access_allowed): @property def vnic_id(self): """ - **[Required]** Gets the vnic_id of this CreateIpv6Details. + Gets the vnic_id of this CreateIpv6Details. The `OCID`__ of the VNIC to assign the IPv6 to. The IPv6 will be in the VNIC's subnet. diff --git a/src/oci/core/models/create_route_table_details.py b/src/oci/core/models/create_route_table_details.py index 58bd111a53..0aefe33a11 100644 --- a/src/oci/core/models/create_route_table_details.py +++ b/src/oci/core/models/create_route_table_details.py @@ -130,7 +130,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateRouteTableDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateRouteTableDetails. @@ -142,7 +143,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateRouteTableDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateRouteTableDetails. diff --git a/src/oci/core/models/create_security_list_details.py b/src/oci/core/models/create_security_list_details.py index e767835622..175b91a18e 100644 --- a/src/oci/core/models/create_security_list_details.py +++ b/src/oci/core/models/create_security_list_details.py @@ -137,7 +137,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateSecurityListDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateSecurityListDetails. @@ -149,7 +150,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateSecurityListDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateSecurityListDetails. diff --git a/src/oci/core/models/create_subnet_details.py b/src/oci/core/models/create_subnet_details.py index 408e15a1f2..b2e776b1ae 100644 --- a/src/oci/core/models/create_subnet_details.py +++ b/src/oci/core/models/create_subnet_details.py @@ -287,7 +287,8 @@ def dhcp_options_id(self, dhcp_options_id): def display_name(self): """ Gets the display_name of this CreateSubnetDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateSubnetDetails. @@ -299,7 +300,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateSubnetDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateSubnetDetails. diff --git a/src/oci/core/models/create_vcn_details.py b/src/oci/core/models/create_vcn_details.py index 9ba739a0cd..8af56b3471 100644 --- a/src/oci/core/models/create_vcn_details.py +++ b/src/oci/core/models/create_vcn_details.py @@ -279,7 +279,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateVcnDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateVcnDetails. @@ -291,7 +292,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateVcnDetails. - A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateVcnDetails. diff --git a/src/oci/core/models/create_virtual_circuit_details.py b/src/oci/core/models/create_virtual_circuit_details.py index 8eed286242..18afc65d64 100644 --- a/src/oci/core/models/create_virtual_circuit_details.py +++ b/src/oci/core/models/create_virtual_circuit_details.py @@ -151,7 +151,7 @@ def __init__(self, **kwargs): def bandwidth_shape_name(self): """ Gets the bandwidth_shape_name of this CreateVirtualCircuitDetails. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. @@ -167,7 +167,7 @@ def bandwidth_shape_name(self): def bandwidth_shape_name(self, bandwidth_shape_name): """ Sets the bandwidth_shape_name of this CreateVirtualCircuitDetails. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. diff --git a/src/oci/core/models/create_vlan_details.py b/src/oci/core/models/create_vlan_details.py index 7d926a1936..29dea84c75 100644 --- a/src/oci/core/models/create_vlan_details.py +++ b/src/oci/core/models/create_vlan_details.py @@ -222,7 +222,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateVlanDetails. - A descriptive name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A descriptive name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :return: The display_name of this CreateVlanDetails. @@ -234,7 +235,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateVlanDetails. - A descriptive name. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A descriptive name. Does not have to be unique, and it's changeable. + Avoid entering confidential information. :param display_name: The display_name of this CreateVlanDetails. diff --git a/src/oci/core/models/create_volume_group_backup_details.py b/src/oci/core/models/create_volume_group_backup_details.py index e23a37f588..3344910c16 100644 --- a/src/oci/core/models/create_volume_group_backup_details.py +++ b/src/oci/core/models/create_volume_group_backup_details.py @@ -81,7 +81,9 @@ def __init__(self, **kwargs): def compartment_id(self): """ Gets the compartment_id of this CreateVolumeGroupBackupDetails. - The OCID of the compartment that will contain the volume group backup. This parameter is optional, by default backup will be created in the same compartment and source volume group. + The OCID of the compartment that will contain the volume group + backup. This parameter is optional, by default backup will be created in + the same compartment and source volume group. :return: The compartment_id of this CreateVolumeGroupBackupDetails. @@ -93,7 +95,9 @@ def compartment_id(self): def compartment_id(self, compartment_id): """ Sets the compartment_id of this CreateVolumeGroupBackupDetails. - The OCID of the compartment that will contain the volume group backup. This parameter is optional, by default backup will be created in the same compartment and source volume group. + The OCID of the compartment that will contain the volume group + backup. This parameter is optional, by default backup will be created in + the same compartment and source volume group. :param compartment_id: The compartment_id of this CreateVolumeGroupBackupDetails. diff --git a/src/oci/core/models/create_volume_group_details.py b/src/oci/core/models/create_volume_group_details.py index 0af338d578..27277a3e8e 100644 --- a/src/oci/core/models/create_volume_group_details.py +++ b/src/oci/core/models/create_volume_group_details.py @@ -187,7 +187,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ Gets the display_name of this CreateVolumeGroupDetails. - A user-friendly name for the volume group. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group. Does not have to be + unique, and it's changeable. Avoid entering confidential information. :return: The display_name of this CreateVolumeGroupDetails. @@ -199,7 +200,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateVolumeGroupDetails. - A user-friendly name for the volume group. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group. Does not have to be + unique, and it's changeable. Avoid entering confidential information. :param display_name: The display_name of this CreateVolumeGroupDetails. diff --git a/src/oci/core/models/cross_connect.py b/src/oci/core/models/cross_connect.py index ba639477fe..3a003aef28 100644 --- a/src/oci/core/models/cross_connect.py +++ b/src/oci/core/models/cross_connect.py @@ -27,9 +27,6 @@ class CrossConnect(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/fastconnect.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/cross_connect_group.py b/src/oci/core/models/cross_connect_group.py index 67699c0067..d95f135af2 100644 --- a/src/oci/core/models/cross_connect_group.py +++ b/src/oci/core/models/cross_connect_group.py @@ -24,9 +24,6 @@ class CrossConnectGroup(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/fastconnect.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/cross_connect_mapping.py b/src/oci/core/models/cross_connect_mapping.py index 08d7f0fd52..55d86f0fb6 100644 --- a/src/oci/core/models/cross_connect_mapping.py +++ b/src/oci/core/models/cross_connect_mapping.py @@ -293,7 +293,7 @@ def customer_bgp_peering_ipv6(self, customer_bgp_peering_ipv6): def oracle_bgp_peering_ipv6(self): """ Gets the oracle_bgp_peering_ipv6 of this CrossConnectMapping. - The IPv6 address for Oracle's end of the BGP session. Only subnet masks from /64 up to /127 are allowed. + The IPv6 address for Oracle's end of the BGP session. Only subnet masks from /64 up to /127 are allowed. If the session goes from Oracle to a customer's edge router, the customer specifies this information. If the session goes from Oracle to a provider's edge router, the provider specifies this. @@ -317,7 +317,7 @@ def oracle_bgp_peering_ipv6(self): def oracle_bgp_peering_ipv6(self, oracle_bgp_peering_ipv6): """ Sets the oracle_bgp_peering_ipv6 of this CrossConnectMapping. - The IPv6 address for Oracle's end of the BGP session. Only subnet masks from /64 up to /127 are allowed. + The IPv6 address for Oracle's end of the BGP session. Only subnet masks from /64 up to /127 are allowed. If the session goes from Oracle to a customer's edge router, the customer specifies this information. If the session goes from Oracle to a provider's edge router, the provider specifies this. diff --git a/src/oci/core/models/dhcp_options.py b/src/oci/core/models/dhcp_options.py index c4f7ac51ed..0b6046c1b6 100644 --- a/src/oci/core/models/dhcp_options.py +++ b/src/oci/core/models/dhcp_options.py @@ -26,9 +26,6 @@ class DhcpOptions(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/dns.htm __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingDHCP.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm diff --git a/src/oci/core/models/drg.py b/src/oci/core/models/drg.py index 4eea45d1b2..98d0a7c3df 100644 --- a/src/oci/core/models/drg.py +++ b/src/oci/core/models/drg.py @@ -20,9 +20,6 @@ class Drg(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/drg_attachment.py b/src/oci/core/models/drg_attachment.py index 905413e013..81bf605bfc 100644 --- a/src/oci/core/models/drg_attachment.py +++ b/src/oci/core/models/drg_attachment.py @@ -13,9 +13,6 @@ class DrgAttachment(object): A link between a DRG and VCN. For more information, see `Overview of the Networking Service`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm """ diff --git a/src/oci/core/models/encryption_domain_config.py b/src/oci/core/models/encryption_domain_config.py new file mode 100644 index 0000000000..b11ee231c6 --- /dev/null +++ b/src/oci/core/models/encryption_domain_config.py @@ -0,0 +1,101 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class EncryptionDomainConfig(object): + """ + Configuration information used by the encryption domain policy. + """ + + def __init__(self, **kwargs): + """ + Initializes a new EncryptionDomainConfig object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param oracle_traffic_selector: + The value to assign to the oracle_traffic_selector property of this EncryptionDomainConfig. + :type oracle_traffic_selector: list[str] + + :param cpe_traffic_selector: + The value to assign to the cpe_traffic_selector property of this EncryptionDomainConfig. + :type cpe_traffic_selector: list[str] + + """ + self.swagger_types = { + 'oracle_traffic_selector': 'list[str]', + 'cpe_traffic_selector': 'list[str]' + } + + self.attribute_map = { + 'oracle_traffic_selector': 'oracleTrafficSelector', + 'cpe_traffic_selector': 'cpeTrafficSelector' + } + + self._oracle_traffic_selector = None + self._cpe_traffic_selector = None + + @property + def oracle_traffic_selector(self): + """ + Gets the oracle_traffic_selector of this EncryptionDomainConfig. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :return: The oracle_traffic_selector of this EncryptionDomainConfig. + :rtype: list[str] + """ + return self._oracle_traffic_selector + + @oracle_traffic_selector.setter + def oracle_traffic_selector(self, oracle_traffic_selector): + """ + Sets the oracle_traffic_selector of this EncryptionDomainConfig. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :param oracle_traffic_selector: The oracle_traffic_selector of this EncryptionDomainConfig. + :type: list[str] + """ + self._oracle_traffic_selector = oracle_traffic_selector + + @property + def cpe_traffic_selector(self): + """ + Gets the cpe_traffic_selector of this EncryptionDomainConfig. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :return: The cpe_traffic_selector of this EncryptionDomainConfig. + :rtype: list[str] + """ + return self._cpe_traffic_selector + + @cpe_traffic_selector.setter + def cpe_traffic_selector(self, cpe_traffic_selector): + """ + Sets the cpe_traffic_selector of this EncryptionDomainConfig. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :param cpe_traffic_selector: The cpe_traffic_selector of this EncryptionDomainConfig. + :type: list[str] + """ + self._cpe_traffic_selector = cpe_traffic_selector + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/core/models/export_image_via_object_storage_uri_details.py b/src/oci/core/models/export_image_via_object_storage_uri_details.py index cda83a15be..886c139fd0 100644 --- a/src/oci/core/models/export_image_via_object_storage_uri_details.py +++ b/src/oci/core/models/export_image_via_object_storage_uri_details.py @@ -46,8 +46,10 @@ def __init__(self, **kwargs): def destination_uri(self): """ **[Required]** Gets the destination_uri of this ExportImageViaObjectStorageUriDetails. - The Object Storage URL to export the image to. See `Object Storage URLs`__ - and `Using Pre-Authenticated Requests`__ for constructing URLs for image import/export. + The Object Storage URL to export the image to. See `Object + Storage URLs`__ + and `Using Pre-Authenticated Requests`__ + for constructing URLs for image import/export. __ https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingpreauthenticatedrequests.htm @@ -62,8 +64,10 @@ def destination_uri(self): def destination_uri(self, destination_uri): """ Sets the destination_uri of this ExportImageViaObjectStorageUriDetails. - The Object Storage URL to export the image to. See `Object Storage URLs`__ - and `Using Pre-Authenticated Requests`__ for constructing URLs for image import/export. + The Object Storage URL to export the image to. See `Object + Storage URLs`__ + and `Using Pre-Authenticated Requests`__ + for constructing URLs for image import/export. __ https://docs.cloud.oracle.com/Content/Compute/Tasks/imageimportexport.htm#URLs __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingpreauthenticatedrequests.htm diff --git a/src/oci/core/models/fast_connect_provider_service_key.py b/src/oci/core/models/fast_connect_provider_service_key.py index 8371727bd8..8febfcd3ef 100644 --- a/src/oci/core/models/fast_connect_provider_service_key.py +++ b/src/oci/core/models/fast_connect_provider_service_key.py @@ -82,7 +82,7 @@ def name(self, name): def bandwidth_shape_name(self): """ Gets the bandwidth_shape_name of this FastConnectProviderServiceKey. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. @@ -98,7 +98,7 @@ def bandwidth_shape_name(self): def bandwidth_shape_name(self, bandwidth_shape_name): """ Sets the bandwidth_shape_name of this FastConnectProviderServiceKey. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. diff --git a/src/oci/core/models/i_scsi_volume_attachment.py b/src/oci/core/models/i_scsi_volume_attachment.py index c509095e9d..9a9c4c70b6 100644 --- a/src/oci/core/models/i_scsi_volume_attachment.py +++ b/src/oci/core/models/i_scsi_volume_attachment.py @@ -159,7 +159,8 @@ def __init__(self, **kwargs): def chap_secret(self): """ Gets the chap_secret of this IScsiVolumeAttachment. - The Challenge-Handshake-Authentication-Protocol (CHAP) secret valid for the associated CHAP user name. + The Challenge-Handshake-Authentication-Protocol (CHAP) secret + valid for the associated CHAP user name. (Also called the \"CHAP password\".) @@ -172,7 +173,8 @@ def chap_secret(self): def chap_secret(self, chap_secret): """ Sets the chap_secret of this IScsiVolumeAttachment. - The Challenge-Handshake-Authentication-Protocol (CHAP) secret valid for the associated CHAP user name. + The Challenge-Handshake-Authentication-Protocol (CHAP) secret + valid for the associated CHAP user name. (Also called the \"CHAP password\".) @@ -185,7 +187,8 @@ def chap_secret(self, chap_secret): def chap_username(self): """ Gets the chap_username of this IScsiVolumeAttachment. - The volume's system-generated Challenge-Handshake-Authentication-Protocol (CHAP) user name. See `RFC 1994`__ for more on CHAP. + The volume's system-generated Challenge-Handshake-Authentication-Protocol + (CHAP) user name. See `RFC 1994`__ for more on CHAP. Example: `ocid1.volume.oc1.phx.` @@ -201,7 +204,8 @@ def chap_username(self): def chap_username(self, chap_username): """ Sets the chap_username of this IScsiVolumeAttachment. - The volume's system-generated Challenge-Handshake-Authentication-Protocol (CHAP) user name. See `RFC 1994`__ for more on CHAP. + The volume's system-generated Challenge-Handshake-Authentication-Protocol + (CHAP) user name. See `RFC 1994`__ for more on CHAP. Example: `ocid1.volume.oc1.phx.` @@ -245,7 +249,8 @@ def ipv4(self, ipv4): def iqn(self): """ **[Required]** Gets the iqn of this IScsiVolumeAttachment. - The target volume's iSCSI Qualified Name in the format defined by `RFC 3720`__. + The target volume's iSCSI Qualified Name in the format defined + by `RFC 3720`__. Example: `iqn.2015-12.us.oracle.com:` @@ -261,7 +266,8 @@ def iqn(self): def iqn(self, iqn): """ Sets the iqn of this IScsiVolumeAttachment. - The target volume's iSCSI Qualified Name in the format defined by `RFC 3720`__. + The target volume's iSCSI Qualified Name in the format defined + by `RFC 3720`__. Example: `iqn.2015-12.us.oracle.com:` diff --git a/src/oci/core/models/image_source_details.py b/src/oci/core/models/image_source_details.py index 979cfb4a4b..c6e450371c 100644 --- a/src/oci/core/models/image_source_details.py +++ b/src/oci/core/models/image_source_details.py @@ -128,7 +128,7 @@ def operating_system_version(self, operating_system_version): def source_image_type(self): """ Gets the source_image_type of this ImageSourceDetails. - The format of the image to be imported. Only monolithic + The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the OCI image format. Allowed values for this property are: "QCOW2", "VMDK" @@ -143,7 +143,7 @@ def source_image_type(self): def source_image_type(self, source_image_type): """ Sets the source_image_type of this ImageSourceDetails. - The format of the image to be imported. Only monolithic + The format of the image to be imported. Only monolithic images are supported. This attribute is not used for exported Oracle images with the OCI image format. diff --git a/src/oci/core/models/instance_agent_config.py b/src/oci/core/models/instance_agent_config.py index 41156ae7f3..c9d47f5921 100644 --- a/src/oci/core/models/instance_agent_config.py +++ b/src/oci/core/models/instance_agent_config.py @@ -10,7 +10,7 @@ @init_model_state_from_kwargs class InstanceAgentConfig(object): """ - Instance agent configuration on the instance + Configuration options for the Oracle Cloud Agent software running on the instance. """ def __init__(self, **kwargs): @@ -44,7 +44,8 @@ def __init__(self, **kwargs): def is_monitoring_disabled(self): """ Gets the is_monitoring_disabled of this InstanceAgentConfig. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. :return: The is_monitoring_disabled of this InstanceAgentConfig. @@ -56,7 +57,8 @@ def is_monitoring_disabled(self): def is_monitoring_disabled(self, is_monitoring_disabled): """ Sets the is_monitoring_disabled of this InstanceAgentConfig. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. :param is_monitoring_disabled: The is_monitoring_disabled of this InstanceAgentConfig. @@ -68,7 +70,7 @@ def is_monitoring_disabled(self, is_monitoring_disabled): def is_management_disabled(self): """ Gets the is_management_disabled of this InstanceAgentConfig. - Whether the agent running on the instance can run all the available management plugins. + Whether Oracle Cloud Agent can run all the available management plugins. :return: The is_management_disabled of this InstanceAgentConfig. @@ -80,7 +82,7 @@ def is_management_disabled(self): def is_management_disabled(self, is_management_disabled): """ Sets the is_management_disabled of this InstanceAgentConfig. - Whether the agent running on the instance can run all the available management plugins. + Whether Oracle Cloud Agent can run all the available management plugins. :param is_management_disabled: The is_management_disabled of this InstanceAgentConfig. diff --git a/src/oci/core/models/instance_agent_features.py b/src/oci/core/models/instance_agent_features.py index b39c726445..9aca7d0b18 100644 --- a/src/oci/core/models/instance_agent_features.py +++ b/src/oci/core/models/instance_agent_features.py @@ -10,7 +10,7 @@ @init_model_state_from_kwargs class InstanceAgentFeatures(object): """ - Instance agent features supported on the image + Oracle Cloud Agent features supported on the image. """ def __init__(self, **kwargs): @@ -44,7 +44,7 @@ def __init__(self, **kwargs): def is_monitoring_supported(self): """ Gets the is_monitoring_supported of this InstanceAgentFeatures. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance. :return: The is_monitoring_supported of this InstanceAgentFeatures. @@ -56,7 +56,7 @@ def is_monitoring_supported(self): def is_monitoring_supported(self, is_monitoring_supported): """ Sets the is_monitoring_supported of this InstanceAgentFeatures. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance. :param is_monitoring_supported: The is_monitoring_supported of this InstanceAgentFeatures. @@ -68,7 +68,7 @@ def is_monitoring_supported(self, is_monitoring_supported): def is_management_supported(self): """ Gets the is_management_supported of this InstanceAgentFeatures. - Whether the agent running on the instance can run all the available management plugins + Whether Oracle Cloud Agent can run all the available management plugins. :return: The is_management_supported of this InstanceAgentFeatures. @@ -80,7 +80,7 @@ def is_management_supported(self): def is_management_supported(self, is_management_supported): """ Sets the is_management_supported of this InstanceAgentFeatures. - Whether the agent running on the instance can run all the available management plugins + Whether Oracle Cloud Agent can run all the available management plugins. :param is_management_supported: The is_management_supported of this InstanceAgentFeatures. diff --git a/src/oci/core/models/instance_configuration_instance_source_via_image_details.py b/src/oci/core/models/instance_configuration_instance_source_via_image_details.py index 298c36c735..0307fcc254 100644 --- a/src/oci/core/models/instance_configuration_instance_source_via_image_details.py +++ b/src/oci/core/models/instance_configuration_instance_source_via_image_details.py @@ -53,7 +53,8 @@ def __init__(self, **kwargs): def boot_volume_size_in_gbs(self): """ Gets the boot_volume_size_in_gbs of this InstanceConfigurationInstanceSourceViaImageDetails. - The size of the boot volume in GBs. The minimum value is 50 GB and the maximum value is 16384 GB (16TB). + The size of the boot volume in GBs. The minimum value is 50 GB and the maximum + value is 16384 GB (16TB). :return: The boot_volume_size_in_gbs of this InstanceConfigurationInstanceSourceViaImageDetails. @@ -65,7 +66,8 @@ def boot_volume_size_in_gbs(self): def boot_volume_size_in_gbs(self, boot_volume_size_in_gbs): """ Sets the boot_volume_size_in_gbs of this InstanceConfigurationInstanceSourceViaImageDetails. - The size of the boot volume in GBs. The minimum value is 50 GB and the maximum value is 16384 GB (16TB). + The size of the boot volume in GBs. The minimum value is 50 GB and the maximum + value is 16384 GB (16TB). :param boot_volume_size_in_gbs: The boot_volume_size_in_gbs of this InstanceConfigurationInstanceSourceViaImageDetails. diff --git a/src/oci/core/models/instance_configuration_launch_instance_agent_config_details.py b/src/oci/core/models/instance_configuration_launch_instance_agent_config_details.py index f1b7667fb7..c8b35d29a7 100644 --- a/src/oci/core/models/instance_configuration_launch_instance_agent_config_details.py +++ b/src/oci/core/models/instance_configuration_launch_instance_agent_config_details.py @@ -10,7 +10,7 @@ @init_model_state_from_kwargs class InstanceConfigurationLaunchInstanceAgentConfigDetails(object): """ - Instance agent configuration options to choose for launching the instance + Configuration options for the Oracle Cloud Agent software running on the instance. """ def __init__(self, **kwargs): @@ -44,8 +44,8 @@ def __init__(self, **kwargs): def is_monitoring_disabled(self): """ Gets the is_monitoring_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. - Default value is false. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. Default value is false (monitoring plugins are enabled). :return: The is_monitoring_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. @@ -57,8 +57,8 @@ def is_monitoring_disabled(self): def is_monitoring_disabled(self, is_monitoring_disabled): """ Sets the is_monitoring_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. - Default value is false. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. Default value is false (monitoring plugins are enabled). :param is_monitoring_disabled: The is_monitoring_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. @@ -70,8 +70,8 @@ def is_monitoring_disabled(self, is_monitoring_disabled): def is_management_disabled(self): """ Gets the is_management_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins. - Default value is false. + Whether Oracle Cloud Agent can run all the available management plugins. + Default value is false (management plugins are enabled). :return: The is_management_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. @@ -83,8 +83,8 @@ def is_management_disabled(self): def is_management_disabled(self, is_management_disabled): """ Sets the is_management_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins. - Default value is false. + Whether Oracle Cloud Agent can run all the available management plugins. + Default value is false (management plugins are enabled). :param is_management_disabled: The is_management_disabled of this InstanceConfigurationLaunchInstanceAgentConfigDetails. diff --git a/src/oci/core/models/instance_configuration_launch_options.py b/src/oci/core/models/instance_configuration_launch_options.py index 53f18508da..aa420fa20e 100644 --- a/src/oci/core/models/instance_configuration_launch_options.py +++ b/src/oci/core/models/instance_configuration_launch_options.py @@ -145,7 +145,7 @@ def boot_volume_type(self): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -167,7 +167,7 @@ def boot_volume_type(self, boot_volume_type): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -185,10 +185,10 @@ def boot_volume_type(self, boot_volume_type): def firmware(self): """ Gets the firmware of this InstanceConfigurationLaunchOptions. - Firmware used to boot VM. Select the option that matches your operating system. - * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating + Firmware used to boot VM. Select the option that matches your operating system. + * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders. - * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the + * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for Oracle-provided images. Allowed values for this property are: "BIOS", "UEFI_64", 'UNKNOWN_ENUM_VALUE'. @@ -204,10 +204,10 @@ def firmware(self): def firmware(self, firmware): """ Sets the firmware of this InstanceConfigurationLaunchOptions. - Firmware used to boot VM. Select the option that matches your operating system. - * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating + Firmware used to boot VM. Select the option that matches your operating system. + * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders. - * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the + * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for Oracle-provided images. @@ -224,7 +224,7 @@ def network_type(self): """ Gets the network_type of this InstanceConfigurationLaunchOptions. Emulation type for the physical network interface card (NIC). - * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. + * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. * `VFIO` - Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking. * `PARAVIRTUALIZED` - VM instances launch with paravirtualized devices using VirtIO drivers. @@ -243,7 +243,7 @@ def network_type(self, network_type): """ Sets the network_type of this InstanceConfigurationLaunchOptions. Emulation type for the physical network interface card (NIC). - * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. + * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. * `VFIO` - Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking. * `PARAVIRTUALIZED` - VM instances launch with paravirtualized devices using VirtIO drivers. @@ -265,7 +265,7 @@ def remote_data_volume_type(self): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -287,7 +287,7 @@ def remote_data_volume_type(self, remote_data_volume_type): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. diff --git a/src/oci/core/models/instance_console_connection.py b/src/oci/core/models/instance_console_connection.py index 87fbc765e3..f1f6491307 100644 --- a/src/oci/core/models/instance_console_connection.py +++ b/src/oci/core/models/instance_console_connection.py @@ -13,8 +13,7 @@ class InstanceConsoleConnection(object): The `InstanceConsoleConnection` API provides you with console access to Compute instances, enabling you to troubleshoot malfunctioning instances remotely. - For more information about console access, see - `Accessing the Console`__. + For more information about instance console connections, see `Troubleshooting Instances Using Instance Console Connections`__. __ https://docs.cloud.oracle.com/Content/Compute/References/serialconsole.htm """ diff --git a/src/oci/core/models/instance_pool_load_balancer_attachment.py b/src/oci/core/models/instance_pool_load_balancer_attachment.py index 5b79399845..cd1ee064ca 100644 --- a/src/oci/core/models/instance_pool_load_balancer_attachment.py +++ b/src/oci/core/models/instance_pool_load_balancer_attachment.py @@ -229,7 +229,9 @@ def port(self, port): def vnic_selection(self): """ **[Required]** Gets the vnic_selection of this InstancePoolLoadBalancerAttachment. - Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool. + Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. + Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration + that is associated with the instance pool. :return: The vnic_selection of this InstancePoolLoadBalancerAttachment. @@ -241,7 +243,9 @@ def vnic_selection(self): def vnic_selection(self, vnic_selection): """ Sets the vnic_selection of this InstancePoolLoadBalancerAttachment. - Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration that is associated with the instance pool. + Indicates which VNIC on each instance in the instance pool should be used to associate with the load balancer. + Possible values are \"PrimaryVnic\" or the displayName of one of the secondary VNICs on the instance configuration + that is associated with the instance pool. :param vnic_selection: The vnic_selection of this InstancePoolLoadBalancerAttachment. diff --git a/src/oci/core/models/instance_pool_summary.py b/src/oci/core/models/instance_pool_summary.py index b4e338de8b..8089296744 100644 --- a/src/oci/core/models/instance_pool_summary.py +++ b/src/oci/core/models/instance_pool_summary.py @@ -182,7 +182,7 @@ def compartment_id(self, compartment_id): def display_name(self): """ Gets the display_name of this InstancePoolSummary. - The user-friendly name. Does not have to be unique. + The user-friendly name. Does not have to be unique. :return: The display_name of this InstancePoolSummary. @@ -194,7 +194,7 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this InstancePoolSummary. - The user-friendly name. Does not have to be unique. + The user-friendly name. Does not have to be unique. :param display_name: The display_name of this InstancePoolSummary. diff --git a/src/oci/core/models/instance_summary.py b/src/oci/core/models/instance_summary.py index 306df0164c..fc7a908117 100644 --- a/src/oci/core/models/instance_summary.py +++ b/src/oci/core/models/instance_summary.py @@ -179,7 +179,7 @@ def compartment_id(self, compartment_id): def display_name(self): """ Gets the display_name of this InstanceSummary. - The user-friendly name. Does not have to be unique. + The user-friendly name. Does not have to be unique. :return: The display_name of this InstanceSummary. @@ -191,7 +191,7 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this InstanceSummary. - The user-friendly name. Does not have to be unique. + The user-friendly name. Does not have to be unique. :param display_name: The display_name of this InstanceSummary. diff --git a/src/oci/core/models/internet_gateway.py b/src/oci/core/models/internet_gateway.py index 9c982fd006..1f76b40178 100644 --- a/src/oci/core/models/internet_gateway.py +++ b/src/oci/core/models/internet_gateway.py @@ -18,9 +18,6 @@ class InternetGateway(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm#scenarios __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/ip_sec_connection.py b/src/oci/core/models/ip_sec_connection.py index 3baefba0a2..171aa0e077 100644 --- a/src/oci/core/models/ip_sec_connection.py +++ b/src/oci/core/models/ip_sec_connection.py @@ -32,9 +32,6 @@ class IPSecConnection(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingIPsec.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/ip_sec_connection_tunnel.py b/src/oci/core/models/ip_sec_connection_tunnel.py index 9e77f72fed..decd225b6f 100644 --- a/src/oci/core/models/ip_sec_connection_tunnel.py +++ b/src/oci/core/models/ip_sec_connection_tunnel.py @@ -27,6 +27,10 @@ class IPSecConnectionTunnel(object): #: This constant has a value of "DOWN_FOR_MAINTENANCE" STATUS_DOWN_FOR_MAINTENANCE = "DOWN_FOR_MAINTENANCE" + #: A constant which can be used with the status property of a IPSecConnectionTunnel. + #: This constant has a value of "PARTIAL_UP" + STATUS_PARTIAL_UP = "PARTIAL_UP" + #: A constant which can be used with the ike_version property of a IPSecConnectionTunnel. #: This constant has a value of "V1" IKE_VERSION_V1 = "V1" @@ -59,6 +63,10 @@ class IPSecConnectionTunnel(object): #: This constant has a value of "STATIC" ROUTING_STATIC = "STATIC" + #: A constant which can be used with the routing property of a IPSecConnectionTunnel. + #: This constant has a value of "POLICY" + ROUTING_POLICY = "POLICY" + def __init__(self, **kwargs): """ Initializes a new IPSecConnectionTunnel object with values from keyword arguments. @@ -82,7 +90,7 @@ def __init__(self, **kwargs): :param status: The value to assign to the status property of this IPSecConnectionTunnel. - Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type status: str @@ -106,9 +114,13 @@ def __init__(self, **kwargs): The value to assign to the bgp_session_info property of this IPSecConnectionTunnel. :type bgp_session_info: oci.core.models.BgpSessionInfo + :param encryption_domain_config: + The value to assign to the encryption_domain_config property of this IPSecConnectionTunnel. + :type encryption_domain_config: oci.core.models.EncryptionDomainConfig + :param routing: The value to assign to the routing property of this IPSecConnectionTunnel. - Allowed values for this property are: "BGP", "STATIC", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "BGP", "STATIC", "POLICY", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type routing: str @@ -131,6 +143,7 @@ def __init__(self, **kwargs): 'lifecycle_state': 'str', 'display_name': 'str', 'bgp_session_info': 'BgpSessionInfo', + 'encryption_domain_config': 'EncryptionDomainConfig', 'routing': 'str', 'time_created': 'datetime', 'time_status_updated': 'datetime' @@ -146,6 +159,7 @@ def __init__(self, **kwargs): 'lifecycle_state': 'lifecycleState', 'display_name': 'displayName', 'bgp_session_info': 'bgpSessionInfo', + 'encryption_domain_config': 'encryptionDomainConfig', 'routing': 'routing', 'time_created': 'timeCreated', 'time_status_updated': 'timeStatusUpdated' @@ -160,6 +174,7 @@ def __init__(self, **kwargs): self._lifecycle_state = None self._display_name = None self._bgp_session_info = None + self._encryption_domain_config = None self._routing = None self._time_created = None self._time_status_updated = None @@ -282,7 +297,7 @@ def status(self): Gets the status of this IPSecConnectionTunnel. The status of the tunnel based on IPSec protocol characteristics. - Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -301,7 +316,7 @@ def status(self, status): :param status: The status of this IPSecConnectionTunnel. :type: str """ - allowed_values = ["UP", "DOWN", "DOWN_FOR_MAINTENANCE"] + allowed_values = ["UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP"] if not value_allowed_none_or_none_sentinel(status, allowed_values): status = 'UNKNOWN_ENUM_VALUE' self._status = status @@ -412,13 +427,33 @@ def bgp_session_info(self, bgp_session_info): """ self._bgp_session_info = bgp_session_info + @property + def encryption_domain_config(self): + """ + Gets the encryption_domain_config of this IPSecConnectionTunnel. + + :return: The encryption_domain_config of this IPSecConnectionTunnel. + :rtype: oci.core.models.EncryptionDomainConfig + """ + return self._encryption_domain_config + + @encryption_domain_config.setter + def encryption_domain_config(self, encryption_domain_config): + """ + Sets the encryption_domain_config of this IPSecConnectionTunnel. + + :param encryption_domain_config: The encryption_domain_config of this IPSecConnectionTunnel. + :type: oci.core.models.EncryptionDomainConfig + """ + self._encryption_domain_config = encryption_domain_config + @property def routing(self): """ Gets the routing of this IPSecConnectionTunnel. The type of routing used for this tunnel (either BGP dynamic routing or static routing). - Allowed values for this property are: "BGP", "STATIC", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "BGP", "STATIC", "POLICY", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -437,7 +472,7 @@ def routing(self, routing): :param routing: The routing of this IPSecConnectionTunnel. :type: str """ - allowed_values = ["BGP", "STATIC"] + allowed_values = ["BGP", "STATIC", "POLICY"] if not value_allowed_none_or_none_sentinel(routing, allowed_values): routing = 'UNKNOWN_ENUM_VALUE' self._routing = routing diff --git a/src/oci/core/models/ipv6.py b/src/oci/core/models/ipv6.py index 74e1cac7d6..a6dc230857 100644 --- a/src/oci/core/models/ipv6.py +++ b/src/oci/core/models/ipv6.py @@ -295,7 +295,7 @@ def ip_address(self): **[Required]** Gets the ip_address of this Ipv6. The IPv6 address of the `IPv6` object. The address is within the private IPv6 CIDR block of the VNIC's subnet (see the `ipv6CidrBlock` attribute for the :class:`Subnet` - object). + object. Example: `2001:0db8:0123:1111:abcd:ef01:2345:6789` @@ -311,7 +311,7 @@ def ip_address(self, ip_address): Sets the ip_address of this Ipv6. The IPv6 address of the `IPv6` object. The address is within the private IPv6 CIDR block of the VNIC's subnet (see the `ipv6CidrBlock` attribute for the :class:`Subnet` - object). + object. Example: `2001:0db8:0123:1111:abcd:ef01:2345:6789` @@ -500,7 +500,7 @@ def time_created(self, time_created): @property def vnic_id(self): """ - **[Required]** Gets the vnic_id of this Ipv6. + Gets the vnic_id of this Ipv6. The `OCID`__ of the VNIC the IPv6 is assigned to. The VNIC and IPv6 must be in the same subnet. diff --git a/src/oci/core/models/launch_instance_agent_config_details.py b/src/oci/core/models/launch_instance_agent_config_details.py index 5bd13fbcfd..cd7ffa4732 100644 --- a/src/oci/core/models/launch_instance_agent_config_details.py +++ b/src/oci/core/models/launch_instance_agent_config_details.py @@ -10,7 +10,7 @@ @init_model_state_from_kwargs class LaunchInstanceAgentConfigDetails(object): """ - Instance agent configuration options to choose for launching the instance + Configuration options for the Oracle Cloud Agent software running on the instance. """ def __init__(self, **kwargs): @@ -44,8 +44,8 @@ def __init__(self, **kwargs): def is_monitoring_disabled(self): """ Gets the is_monitoring_disabled of this LaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. - Default value is false. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. Default value is false (monitoring plugins are enabled). :return: The is_monitoring_disabled of this LaunchInstanceAgentConfigDetails. @@ -57,8 +57,8 @@ def is_monitoring_disabled(self): def is_monitoring_disabled(self, is_monitoring_disabled): """ Sets the is_monitoring_disabled of this LaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. - Default value is false. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. Default value is false (monitoring plugins are enabled). :param is_monitoring_disabled: The is_monitoring_disabled of this LaunchInstanceAgentConfigDetails. @@ -70,8 +70,8 @@ def is_monitoring_disabled(self, is_monitoring_disabled): def is_management_disabled(self): """ Gets the is_management_disabled of this LaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins. - Default value is false. + Whether Oracle Cloud Agent can run all the available management plugins. + Default value is false (management plugins are enabled). :return: The is_management_disabled of this LaunchInstanceAgentConfigDetails. @@ -83,8 +83,8 @@ def is_management_disabled(self): def is_management_disabled(self, is_management_disabled): """ Sets the is_management_disabled of this LaunchInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins. - Default value is false. + Whether Oracle Cloud Agent can run all the available management plugins. + Default value is false (management plugins are enabled). :param is_management_disabled: The is_management_disabled of this LaunchInstanceAgentConfigDetails. diff --git a/src/oci/core/models/launch_instance_details.py b/src/oci/core/models/launch_instance_details.py index 18e77f11ec..1c6322ebef 100644 --- a/src/oci/core/models/launch_instance_details.py +++ b/src/oci/core/models/launch_instance_details.py @@ -897,7 +897,7 @@ def subnet_id(self, subnet_id): def is_pv_encryption_in_transit_enabled(self): """ Gets the is_pv_encryption_in_transit_enabled of this LaunchInstanceDetails. - Whether to enable in-transit encryption for the data volume's paravirtualized attachment. The default value is false. + Whether to enable in-transit encryption for the data volume's paravirtualized attachment. This field applies to both block volumes and boot volumes. The default value is false. :return: The is_pv_encryption_in_transit_enabled of this LaunchInstanceDetails. @@ -909,7 +909,7 @@ def is_pv_encryption_in_transit_enabled(self): def is_pv_encryption_in_transit_enabled(self, is_pv_encryption_in_transit_enabled): """ Sets the is_pv_encryption_in_transit_enabled of this LaunchInstanceDetails. - Whether to enable in-transit encryption for the data volume's paravirtualized attachment. The default value is false. + Whether to enable in-transit encryption for the data volume's paravirtualized attachment. This field applies to both block volumes and boot volumes. The default value is false. :param is_pv_encryption_in_transit_enabled: The is_pv_encryption_in_transit_enabled of this LaunchInstanceDetails. diff --git a/src/oci/core/models/launch_options.py b/src/oci/core/models/launch_options.py index ce192d3392..8c3ddce8ae 100644 --- a/src/oci/core/models/launch_options.py +++ b/src/oci/core/models/launch_options.py @@ -145,7 +145,7 @@ def boot_volume_type(self): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle-provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -167,7 +167,7 @@ def boot_volume_type(self, boot_volume_type): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle-provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -185,10 +185,10 @@ def boot_volume_type(self, boot_volume_type): def firmware(self): """ Gets the firmware of this LaunchOptions. - Firmware used to boot VM. Select the option that matches your operating system. - * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating + Firmware used to boot VM. Select the option that matches your operating system. + * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders. - * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the + * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for Oracle-provided images. Allowed values for this property are: "BIOS", "UEFI_64", 'UNKNOWN_ENUM_VALUE'. @@ -204,10 +204,10 @@ def firmware(self): def firmware(self, firmware): """ Sets the firmware of this LaunchOptions. - Firmware used to boot VM. Select the option that matches your operating system. - * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating + Firmware used to boot VM. Select the option that matches your operating system. + * `BIOS` - Boot VM using BIOS style firmware. This is compatible with both 32 bit and 64 bit operating systems that boot using MBR style bootloaders. - * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the + * `UEFI_64` - Boot VM using UEFI style firmware compatible with 64 bit operating systems. This is the default for Oracle-provided images. @@ -224,7 +224,7 @@ def network_type(self): """ Gets the network_type of this LaunchOptions. Emulation type for the physical network interface card (NIC). - * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. + * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. * `VFIO` - Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking. * `PARAVIRTUALIZED` - VM instances launch with paravirtualized devices using VirtIO drivers. @@ -243,7 +243,7 @@ def network_type(self, network_type): """ Sets the network_type of this LaunchOptions. Emulation type for the physical network interface card (NIC). - * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. + * `E1000` - Emulated Gigabit ethernet controller. Compatible with Linux e1000 network driver. * `VFIO` - Direct attached Virtual Function network controller. This is the networking type when you launch an instance using hardware-assisted (SR-IOV) networking. * `PARAVIRTUALIZED` - VM instances launch with paravirtualized devices using VirtIO drivers. @@ -265,7 +265,7 @@ def remote_data_volume_type(self): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle-provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. @@ -287,7 +287,7 @@ def remote_data_volume_type(self, remote_data_volume_type): * `ISCSI` - ISCSI attached block storage device. * `SCSI` - Emulated SCSI disk. * `IDE` - Emulated IDE disk. - * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data + * `VFIO` - Direct attached Virtual Function storage. This is the default option for local data volumes on Oracle-provided images. * `PARAVIRTUALIZED` - Paravirtualized disk. This is the default for boot volumes and remote block storage volumes on Oracle-provided images. diff --git a/src/oci/core/models/local_peering_gateway.py b/src/oci/core/models/local_peering_gateway.py index 6fcf46c94c..4f953f1505 100644 --- a/src/oci/core/models/local_peering_gateway.py +++ b/src/oci/core/models/local_peering_gateway.py @@ -20,9 +20,6 @@ class LocalPeeringGateway(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/VCNpeering.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/nat_gateway.py b/src/oci/core/models/nat_gateway.py index 50711829cd..f0f02c7e4c 100644 --- a/src/oci/core/models/nat_gateway.py +++ b/src/oci/core/models/nat_gateway.py @@ -21,9 +21,6 @@ class NatGateway(object): policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/NATgateway.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ @@ -264,7 +261,8 @@ def freeform_tags(self, freeform_tags): def id(self): """ **[Required]** Gets the id of this NatGateway. - The `OCID`__ of the NAT gateway. + The `OCID`__ of the + NAT gateway. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -278,7 +276,8 @@ def id(self): def id(self, id): """ Sets the id of this NatGateway. - The `OCID`__ of the NAT gateway. + The `OCID`__ of the + NAT gateway. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm diff --git a/src/oci/core/models/network_security_group.py b/src/oci/core/models/network_security_group.py index fb974c4d4b..cd3e725740 100644 --- a/src/oci/core/models/network_security_group.py +++ b/src/oci/core/models/network_security_group.py @@ -49,9 +49,6 @@ class NetworkSecurityGroup(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/iaas/Content/Network/Concepts/networksecuritygroups.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/peer_region_for_remote_peering.py b/src/oci/core/models/peer_region_for_remote_peering.py index 0701c70130..87eb0b7498 100644 --- a/src/oci/core/models/peer_region_for_remote_peering.py +++ b/src/oci/core/models/peer_region_for_remote_peering.py @@ -10,7 +10,8 @@ @init_model_state_from_kwargs class PeerRegionForRemotePeering(object): """ - Details about a region that supports remote VCN peering. For more information, see `VCN Peering`__. + Details about a region that supports remote VCN peering. For more + information, see `VCN Peering`__. __ https://docs.cloud.oracle.com/Content/Network/Tasks/VCNpeering.htm """ diff --git a/src/oci/core/models/private_ip.py b/src/oci/core/models/private_ip.py index d850dca774..b4e132ff0d 100644 --- a/src/oci/core/models/private_ip.py +++ b/src/oci/core/models/private_ip.py @@ -45,9 +45,6 @@ class PrivateIp(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingIPaddresses.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ @@ -544,7 +541,6 @@ def vnic_id(self): Gets the vnic_id of this PrivateIp. The OCID of the VNIC the private IP is assigned to. The VNIC and private IP must be in the same subnet. - However, if the `PrivateIp` object is being used with a VLAN as part of the Oracle Cloud VMware Solution, the `vnicId` is null. @@ -560,7 +556,6 @@ def vnic_id(self, vnic_id): Sets the vnic_id of this PrivateIp. The OCID of the VNIC the private IP is assigned to. The VNIC and private IP must be in the same subnet. - However, if the `PrivateIp` object is being used with a VLAN as part of the Oracle Cloud VMware Solution, the `vnicId` is null. diff --git a/src/oci/core/models/public_ip.py b/src/oci/core/models/public_ip.py index 5022c8b296..5e4e171cba 100644 --- a/src/oci/core/models/public_ip.py +++ b/src/oci/core/models/public_ip.py @@ -20,9 +20,6 @@ class PublicIp(object): For more information and comparison of the two types, see `Public IP Addresses`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingpublicIPs.htm """ diff --git a/src/oci/core/models/remote_peering_connection.py b/src/oci/core/models/remote_peering_connection.py index 4bdd96db4e..087e631d10 100644 --- a/src/oci/core/models/remote_peering_connection.py +++ b/src/oci/core/models/remote_peering_connection.py @@ -20,9 +20,6 @@ class RemotePeeringConnection(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/VCNpeering.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/route_table.py b/src/oci/core/models/route_table.py index a0d3da7799..55107df54e 100644 --- a/src/oci/core/models/route_table.py +++ b/src/oci/core/models/route_table.py @@ -18,9 +18,6 @@ class RouteTable(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/security_list.py b/src/oci/core/models/security_list.py index a1d3e220d5..7e1f10f3ae 100644 --- a/src/oci/core/models/security_list.py +++ b/src/oci/core/models/security_list.py @@ -28,9 +28,6 @@ class SecurityList(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/securitylists.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/security_rule.py b/src/oci/core/models/security_rule.py index eb7de43c7e..4e60991a0b 100644 --- a/src/oci/core/models/security_rule.py +++ b/src/oci/core/models/security_rule.py @@ -302,7 +302,8 @@ def destination_type(self, destination_type): def direction(self): """ **[Required]** Gets the direction of this SecurityRule. - Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, or `INGRESS` for rules to allow inbound IP packets. + Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, + or `INGRESS` for rules to allow inbound IP packets. Allowed values for this property are: "EGRESS", "INGRESS", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -317,7 +318,8 @@ def direction(self): def direction(self, direction): """ Sets the direction of this SecurityRule. - Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, or `INGRESS` for rules to allow inbound IP packets. + Direction of the security rule. Set to `EGRESS` for rules to allow outbound IP packets, + or `INGRESS` for rules to allow inbound IP packets. :param direction: The direction of this SecurityRule. diff --git a/src/oci/core/models/service_gateway.py b/src/oci/core/models/service_gateway.py index 9576ee7bbc..fca87f365a 100644 --- a/src/oci/core/models/service_gateway.py +++ b/src/oci/core/models/service_gateway.py @@ -22,9 +22,6 @@ class ServiceGateway(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/servicegateway.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ diff --git a/src/oci/core/models/subnet.py b/src/oci/core/models/subnet.py index 2e525b0fdb..7f146014c2 100644 --- a/src/oci/core/models/subnet.py +++ b/src/oci/core/models/subnet.py @@ -20,9 +20,6 @@ class Subnet(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingVCNs.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm diff --git a/src/oci/core/models/tunnel_status.py b/src/oci/core/models/tunnel_status.py index 0a94334164..eb7e539306 100644 --- a/src/oci/core/models/tunnel_status.py +++ b/src/oci/core/models/tunnel_status.py @@ -25,6 +25,10 @@ class TunnelStatus(object): #: This constant has a value of "DOWN_FOR_MAINTENANCE" LIFECYCLE_STATE_DOWN_FOR_MAINTENANCE = "DOWN_FOR_MAINTENANCE" + #: A constant which can be used with the lifecycle_state property of a TunnelStatus. + #: This constant has a value of "PARTIAL_UP" + LIFECYCLE_STATE_PARTIAL_UP = "PARTIAL_UP" + def __init__(self, **kwargs): """ Initializes a new TunnelStatus object with values from keyword arguments. @@ -36,7 +40,7 @@ def __init__(self, **kwargs): :param lifecycle_state: The value to assign to the lifecycle_state property of this TunnelStatus. - Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type lifecycle_state: str @@ -102,7 +106,7 @@ def lifecycle_state(self): Gets the lifecycle_state of this TunnelStatus. The tunnel's current state. - Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -121,7 +125,7 @@ def lifecycle_state(self, lifecycle_state): :param lifecycle_state: The lifecycle_state of this TunnelStatus. :type: str """ - allowed_values = ["UP", "DOWN", "DOWN_FOR_MAINTENANCE"] + allowed_values = ["UP", "DOWN", "DOWN_FOR_MAINTENANCE", "PARTIAL_UP"] if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): lifecycle_state = 'UNKNOWN_ENUM_VALUE' self._lifecycle_state = lifecycle_state diff --git a/src/oci/core/models/update_instance_agent_config_details.py b/src/oci/core/models/update_instance_agent_config_details.py index f4ab832a03..3713e76bd7 100644 --- a/src/oci/core/models/update_instance_agent_config_details.py +++ b/src/oci/core/models/update_instance_agent_config_details.py @@ -10,7 +10,7 @@ @init_model_state_from_kwargs class UpdateInstanceAgentConfigDetails(object): """ - Instance agent configuration options to choose for updating the instance + Configuration options for the Oracle Cloud Agent software running on the instance. """ def __init__(self, **kwargs): @@ -44,7 +44,8 @@ def __init__(self, **kwargs): def is_monitoring_disabled(self): """ Gets the is_monitoring_disabled of this UpdateInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. :return: The is_monitoring_disabled of this UpdateInstanceAgentConfigDetails. @@ -56,7 +57,8 @@ def is_monitoring_disabled(self): def is_monitoring_disabled(self, is_monitoring_disabled): """ Sets the is_monitoring_disabled of this UpdateInstanceAgentConfigDetails. - Whether the agent running on the instance can gather performance metrics and monitor the instance. + Whether Oracle Cloud Agent can gather performance metrics and monitor the instance using the + monitoring plugins. :param is_monitoring_disabled: The is_monitoring_disabled of this UpdateInstanceAgentConfigDetails. @@ -68,7 +70,7 @@ def is_monitoring_disabled(self, is_monitoring_disabled): def is_management_disabled(self): """ Gets the is_management_disabled of this UpdateInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins + Whether Oracle Cloud Agent can run all the available management plugins. :return: The is_management_disabled of this UpdateInstanceAgentConfigDetails. @@ -80,7 +82,7 @@ def is_management_disabled(self): def is_management_disabled(self, is_management_disabled): """ Sets the is_management_disabled of this UpdateInstanceAgentConfigDetails. - Whether the agent running on the instance can run all the available management plugins + Whether Oracle Cloud Agent can run all the available management plugins. :param is_management_disabled: The is_management_disabled of this UpdateInstanceAgentConfigDetails. diff --git a/src/oci/core/models/update_ip_sec_connection_tunnel_details.py b/src/oci/core/models/update_ip_sec_connection_tunnel_details.py index 97c3cf674a..b36f4641e1 100644 --- a/src/oci/core/models/update_ip_sec_connection_tunnel_details.py +++ b/src/oci/core/models/update_ip_sec_connection_tunnel_details.py @@ -21,6 +21,10 @@ class UpdateIPSecConnectionTunnelDetails(object): #: This constant has a value of "STATIC" ROUTING_STATIC = "STATIC" + #: A constant which can be used with the routing property of a UpdateIPSecConnectionTunnelDetails. + #: This constant has a value of "POLICY" + ROUTING_POLICY = "POLICY" + #: A constant which can be used with the ike_version property of a UpdateIPSecConnectionTunnelDetails. #: This constant has a value of "V1" IKE_VERSION_V1 = "V1" @@ -40,7 +44,7 @@ def __init__(self, **kwargs): :param routing: The value to assign to the routing property of this UpdateIPSecConnectionTunnelDetails. - Allowed values for this property are: "BGP", "STATIC" + Allowed values for this property are: "BGP", "STATIC", "POLICY" :type routing: str :param ike_version: @@ -52,25 +56,32 @@ def __init__(self, **kwargs): The value to assign to the bgp_session_config property of this UpdateIPSecConnectionTunnelDetails. :type bgp_session_config: oci.core.models.UpdateIPSecTunnelBgpSessionDetails + :param encryption_domain_config: + The value to assign to the encryption_domain_config property of this UpdateIPSecConnectionTunnelDetails. + :type encryption_domain_config: oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails + """ self.swagger_types = { 'display_name': 'str', 'routing': 'str', 'ike_version': 'str', - 'bgp_session_config': 'UpdateIPSecTunnelBgpSessionDetails' + 'bgp_session_config': 'UpdateIPSecTunnelBgpSessionDetails', + 'encryption_domain_config': 'UpdateIPSecTunnelEncryptionDomainDetails' } self.attribute_map = { 'display_name': 'displayName', 'routing': 'routing', 'ike_version': 'ikeVersion', - 'bgp_session_config': 'bgpSessionConfig' + 'bgp_session_config': 'bgpSessionConfig', + 'encryption_domain_config': 'encryptionDomainConfig' } self._display_name = None self._routing = None self._ike_version = None self._bgp_session_config = None + self._encryption_domain_config = None @property def display_name(self): @@ -104,7 +115,7 @@ def routing(self): Gets the routing of this UpdateIPSecConnectionTunnelDetails. The type of routing to use for this tunnel (either BGP dynamic routing or static routing). - Allowed values for this property are: "BGP", "STATIC" + Allowed values for this property are: "BGP", "STATIC", "POLICY" :return: The routing of this UpdateIPSecConnectionTunnelDetails. @@ -122,7 +133,7 @@ def routing(self, routing): :param routing: The routing of this UpdateIPSecConnectionTunnelDetails. :type: str """ - allowed_values = ["BGP", "STATIC"] + allowed_values = ["BGP", "STATIC", "POLICY"] if not value_allowed_none_or_none_sentinel(routing, allowed_values): raise ValueError( "Invalid value for `routing`, must be None or one of {0}" @@ -182,6 +193,26 @@ def bgp_session_config(self, bgp_session_config): """ self._bgp_session_config = bgp_session_config + @property + def encryption_domain_config(self): + """ + Gets the encryption_domain_config of this UpdateIPSecConnectionTunnelDetails. + + :return: The encryption_domain_config of this UpdateIPSecConnectionTunnelDetails. + :rtype: oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails + """ + return self._encryption_domain_config + + @encryption_domain_config.setter + def encryption_domain_config(self, encryption_domain_config): + """ + Sets the encryption_domain_config of this UpdateIPSecConnectionTunnelDetails. + + :param encryption_domain_config: The encryption_domain_config of this UpdateIPSecConnectionTunnelDetails. + :type: oci.core.models.UpdateIPSecTunnelEncryptionDomainDetails + """ + self._encryption_domain_config = encryption_domain_config + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/core/models/update_ip_sec_tunnel_encryption_domain_details.py b/src/oci/core/models/update_ip_sec_tunnel_encryption_domain_details.py new file mode 100644 index 0000000000..389802005c --- /dev/null +++ b/src/oci/core/models/update_ip_sec_tunnel_encryption_domain_details.py @@ -0,0 +1,102 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateIPSecTunnelEncryptionDomainDetails(object): + """ + Request to enable a multi-encryption domain policy on the VPNaaS tunnel. + The cross product of oracleTrafficSelector and cpeTrafficSelector can't be more than 50. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateIPSecTunnelEncryptionDomainDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param oracle_traffic_selector: + The value to assign to the oracle_traffic_selector property of this UpdateIPSecTunnelEncryptionDomainDetails. + :type oracle_traffic_selector: list[str] + + :param cpe_traffic_selector: + The value to assign to the cpe_traffic_selector property of this UpdateIPSecTunnelEncryptionDomainDetails. + :type cpe_traffic_selector: list[str] + + """ + self.swagger_types = { + 'oracle_traffic_selector': 'list[str]', + 'cpe_traffic_selector': 'list[str]' + } + + self.attribute_map = { + 'oracle_traffic_selector': 'oracleTrafficSelector', + 'cpe_traffic_selector': 'cpeTrafficSelector' + } + + self._oracle_traffic_selector = None + self._cpe_traffic_selector = None + + @property + def oracle_traffic_selector(self): + """ + Gets the oracle_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :return: The oracle_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + :rtype: list[str] + """ + return self._oracle_traffic_selector + + @oracle_traffic_selector.setter + def oracle_traffic_selector(self, oracle_traffic_selector): + """ + Sets the oracle_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your Oracle tenancy. + + + :param oracle_traffic_selector: The oracle_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + :type: list[str] + """ + self._oracle_traffic_selector = oracle_traffic_selector + + @property + def cpe_traffic_selector(self): + """ + Gets the cpe_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :return: The cpe_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + :rtype: list[str] + """ + return self._cpe_traffic_selector + + @cpe_traffic_selector.setter + def cpe_traffic_selector(self, cpe_traffic_selector): + """ + Sets the cpe_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + Lists IPv4 or IPv6-enabled subnets in your on-premises network. + + + :param cpe_traffic_selector: The cpe_traffic_selector of this UpdateIPSecTunnelEncryptionDomainDetails. + :type: list[str] + """ + self._cpe_traffic_selector = cpe_traffic_selector + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/core/models/update_launch_options.py b/src/oci/core/models/update_launch_options.py index d730b2c433..c3a932c9ca 100644 --- a/src/oci/core/models/update_launch_options.py +++ b/src/oci/core/models/update_launch_options.py @@ -191,14 +191,15 @@ def network_type(self, network_type): def is_pv_encryption_in_transit_enabled(self): """ Gets the is_pv_encryption_in_transit_enabled of this UpdateLaunchOptions. - Whether to enable in-transit encryption for the boot volume's paravirtualized attachment. + Whether to enable in-transit encryption for the volume's paravirtualized attachment. + To enable in-transit encryption for block volumes and boot volumes, this field must be set to `true`. Data in transit is transferred over an internal and highly secure network. If you have specific compliance requirements related to the encryption of the data while it is moving between the - instance and the boot volume, you can enable in-transit encryption. In-transit encryption is - not enabled by default. + instance and the boot volume or the block volume, you can enable in-transit encryption. + In-transit encryption is not enabled by default. - All boot volumes are encrypted at rest. + All boot volumes and block volumes are encrypted at rest. For more information, see `Block Volume Encryption`__. @@ -214,14 +215,15 @@ def is_pv_encryption_in_transit_enabled(self): def is_pv_encryption_in_transit_enabled(self, is_pv_encryption_in_transit_enabled): """ Sets the is_pv_encryption_in_transit_enabled of this UpdateLaunchOptions. - Whether to enable in-transit encryption for the boot volume's paravirtualized attachment. + Whether to enable in-transit encryption for the volume's paravirtualized attachment. + To enable in-transit encryption for block volumes and boot volumes, this field must be set to `true`. Data in transit is transferred over an internal and highly secure network. If you have specific compliance requirements related to the encryption of the data while it is moving between the - instance and the boot volume, you can enable in-transit encryption. In-transit encryption is - not enabled by default. + instance and the boot volume or the block volume, you can enable in-transit encryption. + In-transit encryption is not enabled by default. - All boot volumes are encrypted at rest. + All boot volumes and block volumes are encrypted at rest. For more information, see `Block Volume Encryption`__. diff --git a/src/oci/core/models/update_virtual_circuit_details.py b/src/oci/core/models/update_virtual_circuit_details.py index a75fa75287..314e2f4c5a 100644 --- a/src/oci/core/models/update_virtual_circuit_details.py +++ b/src/oci/core/models/update_virtual_circuit_details.py @@ -381,7 +381,7 @@ def provider_state(self): """ Gets the provider_state of this UpdateVirtualCircuitDetails. The provider's state in relation to this virtual circuit. Relevant only - if the customer is using FastConnect via a provider. ACTIVE + if the customer is using FastConnect via a provider. ACTIVE means the provider has provisioned the virtual circuit from their end. INACTIVE means the provider has not yet provisioned the virtual circuit, or has de-provisioned it. @@ -401,7 +401,7 @@ def provider_state(self, provider_state): """ Sets the provider_state of this UpdateVirtualCircuitDetails. The provider's state in relation to this virtual circuit. Relevant only - if the customer is using FastConnect via a provider. ACTIVE + if the customer is using FastConnect via a provider. ACTIVE means the provider has provisioned the virtual circuit from their end. INACTIVE means the provider has not yet provisioned the virtual circuit, or has de-provisioned it. diff --git a/src/oci/core/models/vcn.py b/src/oci/core/models/vcn.py index e2a269a763..4ded6f55e9 100644 --- a/src/oci/core/models/vcn.py +++ b/src/oci/core/models/vcn.py @@ -17,9 +17,6 @@ class Vcn(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/overview.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ @@ -499,7 +496,6 @@ def ipv6_cidr_block(self): value, Oracle provides a *different* CIDR for the `ipv6PublicCidrBlock`. Note that IPv6 addressing is currently supported only in certain regions. See `IPv6 Addresses`__. - Example: `2001:0db8:0123::/48` __ https://docs.cloud.oracle.com/Content/Network/Concepts/ipv6.htm @@ -520,7 +516,6 @@ def ipv6_cidr_block(self, ipv6_cidr_block): value, Oracle provides a *different* CIDR for the `ipv6PublicCidrBlock`. Note that IPv6 addressing is currently supported only in certain regions. See `IPv6 Addresses`__. - Example: `2001:0db8:0123::/48` __ https://docs.cloud.oracle.com/Content/Network/Concepts/ipv6.htm diff --git a/src/oci/core/models/virtual_circuit.py b/src/oci/core/models/virtual_circuit.py index 6573495321..dc629b56db 100644 --- a/src/oci/core/models/virtual_circuit.py +++ b/src/oci/core/models/virtual_circuit.py @@ -30,9 +30,6 @@ class VirtualCircuit(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Concepts/fastconnect.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ @@ -321,7 +318,7 @@ def __init__(self, **kwargs): def bandwidth_shape_name(self): """ Gets the bandwidth_shape_name of this VirtualCircuit. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. @@ -337,7 +334,7 @@ def bandwidth_shape_name(self): def bandwidth_shape_name(self, bandwidth_shape_name): """ Sets the bandwidth_shape_name of this VirtualCircuit. - The provisioned data rate of the connection. To get a list of the + The provisioned data rate of the connection. To get a list of the available bandwidth levels (that is, shapes), see :func:`list_fast_connect_provider_virtual_circuit_bandwidth_shapes`. diff --git a/src/oci/core/models/vnic.py b/src/oci/core/models/vnic.py index ca738dbae6..c4750715e1 100644 --- a/src/oci/core/models/vnic.py +++ b/src/oci/core/models/vnic.py @@ -32,9 +32,6 @@ class Vnic(object): talk to an administrator. If you're an administrator who needs to write policies to give users access, see `Getting Started with Policies`__. - **Warning:** Oracle recommends that you avoid using any confidential information when you - supply string values using the API. - __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingVNICs.htm __ https://docs.cloud.oracle.com/Content/Network/Tasks/managingIPaddresses.htm __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm diff --git a/src/oci/core/models/volume.py b/src/oci/core/models/volume.py index 8602bb5b09..1f72797463 100644 --- a/src/oci/core/models/volume.py +++ b/src/oci/core/models/volume.py @@ -540,7 +540,8 @@ def size_in_gbs(self, size_in_gbs): def size_in_mbs(self): """ **[Required]** Gets the size_in_mbs of this Volume. - The size of the volume in MBs. This field is deprecated. Use sizeInGBs instead. + The size of the volume in MBs. This field is deprecated. Use + sizeInGBs instead. :return: The size_in_mbs of this Volume. @@ -552,7 +553,8 @@ def size_in_mbs(self): def size_in_mbs(self, size_in_mbs): """ Sets the size_in_mbs of this Volume. - The size of the volume in MBs. This field is deprecated. Use sizeInGBs instead. + The size of the volume in MBs. This field is deprecated. Use + sizeInGBs instead. :param size_in_mbs: The size_in_mbs of this Volume. diff --git a/src/oci/core/models/volume_attachment.py b/src/oci/core/models/volume_attachment.py index 80d45af6bd..90b3843ca6 100644 --- a/src/oci/core/models/volume_attachment.py +++ b/src/oci/core/models/volume_attachment.py @@ -376,7 +376,10 @@ def is_read_only(self, is_read_only): def is_shareable(self): """ Gets the is_shareable of this VolumeAttachment. - Whether the attachment should be created in shareable mode. If an attachment is created in shareable mode, then other instances can attach the same volume, provided that they also create their attachments in shareable mode. Only certain volume types can be attached in shareable mode. Defaults to false if not specified. + Whether the attachment should be created in shareable mode. If an attachment + is created in shareable mode, then other instances can attach the same volume, provided + that they also create their attachments in shareable mode. Only certain volume types can + be attached in shareable mode. Defaults to false if not specified. :return: The is_shareable of this VolumeAttachment. @@ -388,7 +391,10 @@ def is_shareable(self): def is_shareable(self, is_shareable): """ Sets the is_shareable of this VolumeAttachment. - Whether the attachment should be created in shareable mode. If an attachment is created in shareable mode, then other instances can attach the same volume, provided that they also create their attachments in shareable mode. Only certain volume types can be attached in shareable mode. Defaults to false if not specified. + Whether the attachment should be created in shareable mode. If an attachment + is created in shareable mode, then other instances can attach the same volume, provided + that they also create their attachments in shareable mode. Only certain volume types can + be attached in shareable mode. Defaults to false if not specified. :param is_shareable: The is_shareable of this VolumeAttachment. diff --git a/src/oci/core/models/volume_backup_policy_assignment.py b/src/oci/core/models/volume_backup_policy_assignment.py index bac10baa05..46b8a8e809 100644 --- a/src/oci/core/models/volume_backup_policy_assignment.py +++ b/src/oci/core/models/volume_backup_policy_assignment.py @@ -135,7 +135,8 @@ def policy_id(self, policy_id): def time_created(self): """ **[Required]** Gets the time_created of this VolumeBackupPolicyAssignment. - The date and time the volume backup policy was assigned to the volume. The format is defined by `RFC3339`__. + The date and time the volume backup policy was assigned to the volume. The format is + defined by `RFC3339`__. __ https://tools.ietf.org/html/rfc3339 @@ -149,7 +150,8 @@ def time_created(self): def time_created(self, time_created): """ Sets the time_created of this VolumeBackupPolicyAssignment. - The date and time the volume backup policy was assigned to the volume. The format is defined by `RFC3339`__. + The date and time the volume backup policy was assigned to the volume. The format is + defined by `RFC3339`__. __ https://tools.ietf.org/html/rfc3339 diff --git a/src/oci/core/models/volume_backup_schedule.py b/src/oci/core/models/volume_backup_schedule.py index f1f77ed265..e7449446bf 100644 --- a/src/oci/core/models/volume_backup_schedule.py +++ b/src/oci/core/models/volume_backup_schedule.py @@ -265,7 +265,9 @@ def backup_type(self, backup_type): def offset_seconds(self): """ Gets the offset_seconds of this VolumeBackupSchedule. - The number of seconds that the volume backup start time should be shifted from the default interval boundaries specified by the period. The volume backup start time is the frequency start time plus the offset. + The number of seconds that the volume backup start + time should be shifted from the default interval boundaries specified by + the period. The volume backup start time is the frequency start time plus the offset. :return: The offset_seconds of this VolumeBackupSchedule. @@ -277,7 +279,9 @@ def offset_seconds(self): def offset_seconds(self, offset_seconds): """ Sets the offset_seconds of this VolumeBackupSchedule. - The number of seconds that the volume backup start time should be shifted from the default interval boundaries specified by the period. The volume backup start time is the frequency start time plus the offset. + The number of seconds that the volume backup start + time should be shifted from the default interval boundaries specified by + the period. The volume backup start time is the frequency start time plus the offset. :param offset_seconds: The offset_seconds of this VolumeBackupSchedule. @@ -319,11 +323,16 @@ def period(self, period): def offset_type(self): """ Gets the offset_type of this VolumeBackupSchedule. - Indicates how the offset is defined. If value is `STRUCTURED`, then `hourOfDay`, `dayOfWeek`, `dayOfMonth`, and `month` fields are used and `offsetSeconds` will be ignored in requests and users should ignore its value from the responses. + Indicates how the offset is defined. If value is `STRUCTURED`, + then `hourOfDay`, `dayOfWeek`, `dayOfMonth`, and `month` fields are used + and `offsetSeconds` will be ignored in requests and users should ignore its + value from the responses. - `hourOfDay` is applicable for periods `ONE_DAY`, `ONE_WEEK`, `ONE_MONTH` and `ONE_YEAR`. + `hourOfDay` is applicable for periods `ONE_DAY`, + `ONE_WEEK`, `ONE_MONTH` and `ONE_YEAR`. - `dayOfWeek` is applicable for period `ONE_WEEK`. + `dayOfWeek` is applicable for period + `ONE_WEEK`. `dayOfMonth` is applicable for periods `ONE_MONTH` and `ONE_YEAR`. @@ -331,9 +340,12 @@ def offset_type(self): They will be ignored in the requests for inapplicable periods. - If value is `NUMERIC_SECONDS`, then `offsetSeconds` will be used for both requests and responses and the structured fields will be ignored in the requests and users should ignore their values from the responses. + If value is `NUMERIC_SECONDS`, then `offsetSeconds` + will be used for both requests and responses and the structured fields will be + ignored in the requests and users should ignore their values from the responses. - For clients using older versions of Apis and not sending `offsetType` in their requests, the behaviour is just like `NUMERIC_SECONDS`. + For clients using older versions of Apis and not sending `offsetType` in their + requests, the behaviour is just like `NUMERIC_SECONDS`. Allowed values for this property are: "STRUCTURED", "NUMERIC_SECONDS", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -348,11 +360,16 @@ def offset_type(self): def offset_type(self, offset_type): """ Sets the offset_type of this VolumeBackupSchedule. - Indicates how the offset is defined. If value is `STRUCTURED`, then `hourOfDay`, `dayOfWeek`, `dayOfMonth`, and `month` fields are used and `offsetSeconds` will be ignored in requests and users should ignore its value from the responses. + Indicates how the offset is defined. If value is `STRUCTURED`, + then `hourOfDay`, `dayOfWeek`, `dayOfMonth`, and `month` fields are used + and `offsetSeconds` will be ignored in requests and users should ignore its + value from the responses. - `hourOfDay` is applicable for periods `ONE_DAY`, `ONE_WEEK`, `ONE_MONTH` and `ONE_YEAR`. + `hourOfDay` is applicable for periods `ONE_DAY`, + `ONE_WEEK`, `ONE_MONTH` and `ONE_YEAR`. - `dayOfWeek` is applicable for period `ONE_WEEK`. + `dayOfWeek` is applicable for period + `ONE_WEEK`. `dayOfMonth` is applicable for periods `ONE_MONTH` and `ONE_YEAR`. @@ -360,9 +377,12 @@ def offset_type(self, offset_type): They will be ignored in the requests for inapplicable periods. - If value is `NUMERIC_SECONDS`, then `offsetSeconds` will be used for both requests and responses and the structured fields will be ignored in the requests and users should ignore their values from the responses. + If value is `NUMERIC_SECONDS`, then `offsetSeconds` + will be used for both requests and responses and the structured fields will be + ignored in the requests and users should ignore their values from the responses. - For clients using older versions of Apis and not sending `offsetType` in their requests, the behaviour is just like `NUMERIC_SECONDS`. + For clients using older versions of Apis and not sending `offsetType` in their + requests, the behaviour is just like `NUMERIC_SECONDS`. :param offset_type: The offset_type of this VolumeBackupSchedule. diff --git a/src/oci/core/models/volume_group.py b/src/oci/core/models/volume_group.py index 6e2e28e6c7..d8fd07c2fc 100644 --- a/src/oci/core/models/volume_group.py +++ b/src/oci/core/models/volume_group.py @@ -231,7 +231,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ **[Required]** Gets the display_name of this VolumeGroup. - A user-friendly name for the volume group. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group. Does not have to be + unique, and it's changeable. Avoid entering confidential information. :return: The display_name of this VolumeGroup. @@ -243,7 +244,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this VolumeGroup. - A user-friendly name for the volume group. Does not have to be unique, and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group. Does not have to be + unique, and it's changeable. Avoid entering confidential information. :param display_name: The display_name of this VolumeGroup. @@ -463,7 +465,8 @@ def volume_ids(self, volume_ids): def is_hydrated(self): """ Gets the is_hydrated of this VolumeGroup. - Specifies whether the newly created cloned volume group's data has finished copying from the source volume group or backup. + Specifies whether the newly created cloned volume group's data has finished copying + from the source volume group or backup. :return: The is_hydrated of this VolumeGroup. @@ -475,7 +478,8 @@ def is_hydrated(self): def is_hydrated(self, is_hydrated): """ Sets the is_hydrated of this VolumeGroup. - Specifies whether the newly created cloned volume group's data has finished copying from the source volume group or backup. + Specifies whether the newly created cloned volume group's data has finished copying + from the source volume group or backup. :param is_hydrated: The is_hydrated of this VolumeGroup. diff --git a/src/oci/core/models/volume_group_backup.py b/src/oci/core/models/volume_group_backup.py index cd82ab8340..fcef6d97fe 100644 --- a/src/oci/core/models/volume_group_backup.py +++ b/src/oci/core/models/volume_group_backup.py @@ -275,7 +275,8 @@ def defined_tags(self, defined_tags): def display_name(self): """ **[Required]** Gets the display_name of this VolumeGroupBackup. - A user-friendly name for the volume group backup. Does not have to be unique and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group backup. Does not have + to be unique and it's changeable. Avoid entering confidential information. :return: The display_name of this VolumeGroupBackup. @@ -287,7 +288,8 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this VolumeGroupBackup. - A user-friendly name for the volume group backup. Does not have to be unique and it's changeable. Avoid entering confidential information. + A user-friendly name for the volume group backup. Does not have + to be unique and it's changeable. Avoid entering confidential information. :param display_name: The display_name of this VolumeGroupBackup. @@ -471,7 +473,8 @@ def size_in_gbs(self, size_in_gbs): def source_type(self): """ Gets the source_type of this VolumeGroupBackup. - Specifies whether the volume group backup was created manually, or via scheduled backup policy. + Specifies whether the volume group backup was created manually, or via scheduled + backup policy. Allowed values for this property are: "MANUAL", "SCHEDULED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -486,7 +489,8 @@ def source_type(self): def source_type(self, source_type): """ Sets the source_type of this VolumeGroupBackup. - Specifies whether the volume group backup was created manually, or via scheduled backup policy. + Specifies whether the volume group backup was created manually, or via scheduled + backup policy. :param source_type: The source_type of this VolumeGroupBackup. @@ -590,8 +594,9 @@ def unique_size_in_mbs(self): """ Gets the unique_size_in_mbs of this VolumeGroupBackup. The aggregate size used by the volume group backup, in MBs. - It is typically smaller than sizeInMBs, depending on the space - consumed on the volume group and whether the volume backup is full or incremental. + + It is typically smaller than sizeInMBs, depending on the spaceconsumed + on the volume group and whether the volume backup is full or incremental. :return: The unique_size_in_mbs of this VolumeGroupBackup. @@ -604,8 +609,9 @@ def unique_size_in_mbs(self, unique_size_in_mbs): """ Sets the unique_size_in_mbs of this VolumeGroupBackup. The aggregate size used by the volume group backup, in MBs. - It is typically smaller than sizeInMBs, depending on the space - consumed on the volume group and whether the volume backup is full or incremental. + + It is typically smaller than sizeInMBs, depending on the spaceconsumed + on the volume group and whether the volume backup is full or incremental. :param unique_size_in_mbs: The unique_size_in_mbs of this VolumeGroupBackup. @@ -618,8 +624,9 @@ def unique_size_in_gbs(self): """ Gets the unique_size_in_gbs of this VolumeGroupBackup. The aggregate size used by the volume group backup, in GBs. - It is typically smaller than sizeInGBs, depending on the space - consumed on the volume group and whether the volume backup is full or incremental. + + It is typically smaller than sizeInGBs, depending on the spaceconsumed + on the volume group and whether the volume backup is full or incremental. :return: The unique_size_in_gbs of this VolumeGroupBackup. @@ -632,8 +639,9 @@ def unique_size_in_gbs(self, unique_size_in_gbs): """ Sets the unique_size_in_gbs of this VolumeGroupBackup. The aggregate size used by the volume group backup, in GBs. - It is typically smaller than sizeInGBs, depending on the space - consumed on the volume group and whether the volume backup is full or incremental. + + It is typically smaller than sizeInGBs, depending on the spaceconsumed + on the volume group and whether the volume backup is full or incremental. :param unique_size_in_gbs: The unique_size_in_gbs of this VolumeGroupBackup. diff --git a/src/oci/core/virtual_network_client.py b/src/oci/core/virtual_network_client.py index ec77f7276f..057a4f2942 100644 --- a/src/oci/core/virtual_network_client.py +++ b/src/oci/core/virtual_network_client.py @@ -292,7 +292,7 @@ def add_vcn_cidr(self, vcn_id, add_vcn_cidr_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -466,7 +466,7 @@ def attach_service_id(self, service_gateway_id, attach_service_details, **kwargs :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -2592,7 +2592,7 @@ def change_vlan_compartment(self, vlan_id, change_vlan_compartment_details, **kw :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -4918,7 +4918,7 @@ def delete_byoip_range(self, byoip_range_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -4997,7 +4997,7 @@ def delete_cpe(self, cpe_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5073,7 +5073,7 @@ def delete_cross_connect(self, cross_connect_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5150,7 +5150,7 @@ def delete_cross_connect_group(self, cross_connect_group_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5229,7 +5229,7 @@ def delete_dhcp_options(self, dhcp_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5307,7 +5307,7 @@ def delete_drg(self, drg_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5384,7 +5384,7 @@ def delete_drg_attachment(self, drg_attachment_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5463,7 +5463,7 @@ def delete_internet_gateway(self, ig_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5545,7 +5545,7 @@ def delete_ip_sec_connection(self, ipsc_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5623,7 +5623,7 @@ def delete_ipv6(self, ipv6_id, **kwargs): :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -5707,7 +5707,7 @@ def delete_local_peering_gateway(self, local_peering_gateway_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5788,7 +5788,7 @@ def delete_nat_gateway(self, nat_gateway_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5871,7 +5871,7 @@ def delete_network_security_group(self, network_security_group_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -5958,7 +5958,7 @@ def delete_private_ip(self, private_ip_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6047,7 +6047,7 @@ def delete_public_ip(self, public_ip_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6132,7 +6132,7 @@ def delete_public_ip_pool(self, public_ip_pool_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6212,7 +6212,7 @@ def delete_remote_peering_connection(self, remote_peering_connection_id, **kwarg :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6291,7 +6291,7 @@ def delete_route_table(self, rt_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6370,7 +6370,7 @@ def delete_security_list(self, security_list_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6448,7 +6448,7 @@ def delete_service_gateway(self, service_gateway_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6525,7 +6525,7 @@ def delete_subnet(self, subnet_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6604,7 +6604,7 @@ def delete_vcn(self, vcn_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6683,7 +6683,7 @@ def delete_virtual_circuit(self, virtual_circuit_id, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -6760,7 +6760,7 @@ def delete_vlan(self, vlan_id, **kwargs): :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -6857,7 +6857,7 @@ def detach_service_id(self, service_gateway_id, detach_service_details, **kwargs :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -10562,7 +10562,8 @@ def list_cross_connect_groups(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the specified lifecycle state. The value is case insensitive. + A filter to return only resources that match the specified lifecycle + state. The value is case insensitive. Allowed values are: "PROVISIONING", "PROVISIONED", "INACTIVE", "TERMINATING", "TERMINATED" @@ -10794,7 +10795,8 @@ def list_cross_connects(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the specified lifecycle state. The value is case insensitive. + A filter to return only resources that match the specified lifecycle + state. The value is case insensitive. Allowed values are: "PENDING_CUSTOMER", "PROVISIONING", "PROVISIONED", "INACTIVE", "TERMINATING", "TERMINATED" @@ -11033,7 +11035,8 @@ def list_dhcp_options(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -11561,7 +11564,8 @@ def list_internet_gateways(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -12106,7 +12110,8 @@ def list_nat_gateways(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the specified lifecycle state. The value is case insensitive. + A filter to return only resources that match the specified lifecycle + state. The value is case insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -12521,7 +12526,8 @@ def list_network_security_groups(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the specified lifecycle state. The value is case insensitive. + A filter to return only resources that match the specified lifecycle + state. The value is case insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -13174,7 +13180,8 @@ def list_route_tables(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -13323,7 +13330,8 @@ def list_security_lists(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -13469,7 +13477,8 @@ def list_service_gateways(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state. The state value is case-insensitive. + A filter to return only resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED" @@ -13697,7 +13706,8 @@ def list_subnets(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING" @@ -13840,7 +13850,8 @@ def list_vcns(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING" @@ -14029,7 +14040,9 @@ def list_virtual_circuit_public_prefixes(self, virtual_circuit_id, **kwargs): The OCID of the virtual circuit. :param str verification_state: (optional) - A filter to only return resources that match the given verification state. + A filter to only return resources that match the given verification + state. + The state value is case-insensitive. Allowed values are: "IN_PROGRESS", "COMPLETED", "FAILED" @@ -14158,7 +14171,8 @@ def list_virtual_circuits(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the specified lifecycle state. The value is case insensitive. + A filter to return only resources that match the specified lifecycle + state. The value is case insensitive. Allowed values are: "PENDING_PROVIDER", "VERIFYING", "PROVISIONING", "PROVISIONED", "FAILED", "INACTIVE", "TERMINATING", "TERMINATED" @@ -14308,7 +14322,8 @@ def list_vlans(self, compartment_id, vcn_id, **kwargs): If you need to contact Oracle about a particular request, please provide the request ID. :param str lifecycle_state: (optional) - A filter to only return resources that match the given lifecycle state. The state value is case-insensitive. + A filter to only return resources that match the given lifecycle + state. The state value is case-insensitive. Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING" @@ -14439,7 +14454,7 @@ def modify_vcn_cidr(self, vcn_id, modify_vcn_cidr_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -14708,7 +14723,7 @@ def remove_vcn_cidr(self, vcn_id, remove_vcn_cidr_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -14800,7 +14815,7 @@ def update_byoip_range(self, byoip_range_id, update_byoip_range_details, **kwarg :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -14885,7 +14900,7 @@ def update_cpe(self, cpe_id, update_cpe_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -14967,7 +14982,7 @@ def update_cross_connect(self, cross_connect_id, update_cross_connect_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15050,7 +15065,7 @@ def update_cross_connect_group(self, cross_connect_group_id, update_cross_connec :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15135,7 +15150,7 @@ def update_dhcp_options(self, dhcp_id, update_dhcp_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15217,7 +15232,7 @@ def update_drg(self, drg_id, update_drg_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15300,7 +15315,7 @@ def update_drg_attachment(self, drg_attachment_id, update_drg_attachment_details :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15386,7 +15401,7 @@ def update_internet_gateway(self, ig_id, update_internet_gateway_details, **kwar :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15471,7 +15486,7 @@ def update_ip_sec_connection(self, ipsc_id, update_ip_sec_connection_details, ** :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15569,7 +15584,7 @@ def update_ip_sec_connection_tunnel(self, ipsc_id, tunnel_id, update_ip_sec_conn :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -15665,7 +15680,7 @@ def update_ip_sec_connection_tunnel_shared_secret(self, ipsc_id, tunnel_id, upda :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15756,7 +15771,7 @@ def update_ipv6(self, ipv6_id, update_ipv6_details, **kwargs): :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -15844,7 +15859,7 @@ def update_local_peering_gateway(self, local_peering_gateway_id, update_local_pe :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -15928,7 +15943,7 @@ def update_nat_gateway(self, nat_gateway_id, update_nat_gateway_details, **kwarg :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16026,7 +16041,7 @@ def update_network_security_group(self, network_security_group_id, update_networ :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16191,7 +16206,7 @@ def update_private_ip(self, private_ip_id, update_private_ip_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16313,7 +16328,7 @@ def update_public_ip(self, public_ip_id, update_public_ip_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16401,7 +16416,7 @@ def update_public_ip_pool(self, public_ip_pool_id, update_public_ip_pool_details :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16485,7 +16500,7 @@ def update_remote_peering_connection(self, remote_peering_connection_id, update_ :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16570,7 +16585,7 @@ def update_route_table(self, rt_id, update_route_table_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16656,7 +16671,7 @@ def update_security_list(self, security_list_id, update_security_list_details, * :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16741,7 +16756,7 @@ def update_service_gateway(self, service_gateway_id, update_service_gateway_deta :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16823,7 +16838,7 @@ def update_subnet(self, subnet_id, update_subnet_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -16912,7 +16927,7 @@ def update_tunnel_cpe_device_config(self, ipsc_id, tunnel_id, update_tunnel_cpe_ :param str if_match: (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 + 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. :param str opc_retry_token: (optional) @@ -17014,7 +17029,7 @@ def update_vcn(self, vcn_id, update_vcn_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -17121,7 +17136,7 @@ def update_virtual_circuit(self, virtual_circuit_id, update_virtual_circuit_deta :param str if_match: (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 + 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. :param obj retry_strategy: (optional) @@ -17206,7 +17221,7 @@ def update_vlan(self, vlan_id, update_vlan_details, **kwargs): :param str if_match: (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 + 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. :param str opc_request_id: (optional) @@ -17294,7 +17309,7 @@ def update_vnic(self, vnic_id, update_vnic_details, **kwargs): :param str if_match: (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 + 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. :param obj retry_strategy: (optional) diff --git a/src/oci/database/database_client.py b/src/oci/database/database_client.py index 2cf6a14fa4..6438691ec6 100644 --- a/src/oci/database/database_client.py +++ b/src/oci/database/database_client.py @@ -1295,20 +1295,21 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur header_params=header_params, body=change_exadata_infrastructure_compartment_details) - def change_key_store_compartment(self, change_key_store_compartment_details, key_store_id, **kwargs): + def change_external_container_database_compartment(self, change_compartment_details, external_container_database_id, **kwargs): """ - Move the key store resource to the specified compartment. - For more information about moving key stores, see + Move the :func:`create_external_container_database_details` + and its dependent resources to the specified compartment. + For more information about moving external container databases, see `Moving Database Resources to a Different Compartment`__. __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeKeyStoreCompartmentDetails change_key_store_compartment_details: (required) - Request to move key store to a different compartment + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the external container database to a different compartment. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1339,9 +1340,9 @@ def change_key_store_compartment(self, change_key_store_compartment_details, key :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_key_store_compartment API. + Click `here `__ to see an example of how to use change_external_container_database_compartment API. """ - resource_path = "/keyStores/{keyStoreId}/actions/changeCompartment" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/changeCompartment" method = "POST" # Don't accept unknown kwargs @@ -1354,10 +1355,10 @@ def change_key_store_compartment(self, change_key_store_compartment_details, key extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "change_key_store_compartment got unknown kwargs: {!r}".format(extra_kwargs)) + "change_external_container_database_compartment got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "keyStoreId": key_store_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1388,26 +1389,29 @@ def change_key_store_compartment(self, change_key_store_compartment_details, key method=method, path_params=path_params, header_params=header_params, - body=change_key_store_compartment_details) + body=change_compartment_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=change_key_store_compartment_details) + body=change_compartment_details) - def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, vm_cluster_id, **kwargs): + def change_external_non_container_database_compartment(self, change_compartment_details, external_non_container_database_id, **kwargs): """ - Moves a VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. - To move a cloud VM cluster in an Exadata Cloud Service instance to another compartment, use the :func:`change_cloud_vm_cluster_compartment` operation. + Move the external non-container database and its dependent resources to the specified compartment. + For more information about moving external non-container databases, see + `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeVmClusterCompartmentDetails change_vm_cluster_compartment_details: (required) - Request to move the Exadata Cloud@Customer VM cluster to a different compartment. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the external non-container database to a different compartment. + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1438,9 +1442,9 @@ def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, v :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_vm_cluster_compartment API. + Click `here `__ to see an example of how to use change_external_non_container_database_compartment API. """ - resource_path = "/vmClusters/{vmClusterId}/actions/changeCompartment" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/changeCompartment" method = "POST" # Don't accept unknown kwargs @@ -1453,10 +1457,10 @@ def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, v extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "change_vm_cluster_compartment got unknown kwargs: {!r}".format(extra_kwargs)) + "change_external_non_container_database_compartment got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1487,37 +1491,35 @@ def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, v method=method, path_params=path_params, header_params=header_params, - body=change_vm_cluster_compartment_details) + body=change_compartment_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=change_vm_cluster_compartment_details) + body=change_compartment_details) - def complete_external_backup_job(self, backup_id, complete_external_backup_job_details, **kwargs): + def change_external_pluggable_database_compartment(self, change_compartment_details, external_pluggable_database_id, **kwargs): """ - Changes the status of the standalone backup resource to `ACTIVE` after the backup is created from the on-premises database and placed in Oracle Cloud Infrastructure Object Storage. + Move the :func:`create_external_pluggable_database_details` and + its dependent resources to the specified compartment. + For more information about moving external pluggable databases, see + `Moving Database Resources to a Different Compartment`__. - **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the + :func:`create_external_pluggable_database_details` resource + to a different compartment. - :param str backup_id: (required) - The backup `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.CompleteExternalBackupJobDetails complete_external_backup_job_details: (required) - Updates the status of the backup resource. - - :param str if_match: (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. - :param str opc_retry_token: (optional) 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 @@ -1525,6 +1527,14 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1533,28 +1543,29 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use complete_external_backup_job API. + Click `here `__ to see an example of how to use change_external_pluggable_database_compartment API. """ - resource_path = "/externalBackupJobs/{backupId}/actions/complete" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/changeCompartment" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "complete_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) + "change_external_pluggable_database_compartment got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "backupId": backup_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1566,8 +1577,9 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -1584,24 +1596,31 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d method=method, path_params=path_params, header_params=header_params, - body=complete_external_backup_job_details, - response_type="ExternalBackupJob") + body=change_compartment_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=complete_external_backup_job_details, - response_type="ExternalBackupJob") + body=change_compartment_details) - def create_autonomous_container_database(self, create_autonomous_container_database_details, **kwargs): + def change_key_store_compartment(self, change_key_store_compartment_details, key_store_id, **kwargs): """ - Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure. + Move the key store resource to the specified compartment. + For more information about moving key stores, see + `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.CreateAutonomousContainerDatabaseDetails create_autonomous_container_database_details: (required) - Request to create an Autonomous Container Database in a specified Autonomous Exadata Infrastructure. + + :param oci.database.models.ChangeKeyStoreCompartmentDetails change_key_store_compartment_details: (required) + Request to move key store to a different compartment + + :param str key_store_id: (required) + The `OCID`__ of the key store. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1610,6 +1629,14 @@ def create_autonomous_container_database(self, create_autonomous_container_datab has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1618,29 +1645,43 @@ def create_autonomous_container_database(self, create_autonomous_container_datab To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_autonomous_container_database API. + Click `here `__ to see an example of how to use change_key_store_compartment API. """ - resource_path = "/autonomousContainerDatabases" + resource_path = "/keyStores/{keyStoreId}/actions/changeCompartment" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + "change_key_store_compartment got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "keyStoreId": key_store_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -1655,24 +1696,30 @@ def create_autonomous_container_database(self, create_autonomous_container_datab self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_container_database_details, - response_type="AutonomousContainerDatabase") + body=change_key_store_compartment_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_container_database_details, - response_type="AutonomousContainerDatabase") + body=change_key_store_compartment_details) - def create_autonomous_database(self, create_autonomous_database_details, **kwargs): + def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, vm_cluster_id, **kwargs): """ - Creates a new Autonomous Database. + Moves a VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. + To move a cloud VM cluster in an Exadata Cloud Service instance to another compartment, use the :func:`change_cloud_vm_cluster_compartment` operation. - :param oci.database.models.CreateAutonomousDatabaseBase create_autonomous_database_details: (required) - Request to create a new Autonomous Database. + :param oci.database.models.ChangeVmClusterCompartmentDetails change_vm_cluster_compartment_details: (required) + Request to move the Exadata Cloud@Customer VM cluster to a different compartment. + + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1684,6 +1731,11 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1692,31 +1744,43 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_autonomous_database API. + Click `here `__ to see an example of how to use change_vm_cluster_compartment API. """ - resource_path = "/autonomousDatabases" + resource_path = "/vmClusters/{vmClusterId}/actions/changeCompartment" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "opc_retry_token", - "opc_request_id" + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "change_vm_cluster_compartment got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "vmClusterId": vm_cluster_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -1731,24 +1795,28 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_database_details, - response_type="AutonomousDatabase") + body=change_vm_cluster_compartment_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_database_details, - response_type="AutonomousDatabase") + body=change_vm_cluster_compartment_details) - def create_autonomous_database_backup(self, create_autonomous_database_backup_details, **kwargs): + def check_external_database_connector_connection_status(self, external_database_connector_id, **kwargs): """ - Creates a new Autonomous Database backup for the specified database based on the provided request parameters. + Check the status of the external database connection specified in this connector. + This operation will refresh the connectionStatus and timeConnectionStatusLastUpdated fields. - :param oci.database.models.CreateAutonomousDatabaseBackupDetails create_autonomous_database_backup_details: (required) - Request to create a new Autonomous Database backup. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1760,6 +1828,11 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1768,31 +1841,43 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseBackup` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_autonomous_database_backup API. + Click `here `__ to see an example of how to use check_external_database_connector_connection_status API. """ - resource_path = "/autonomousDatabaseBackups" + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}/actions/checkConnectionStatus" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "opc_retry_token", - "opc_request_id" + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_autonomous_database_backup got unknown kwargs: {!r}".format(extra_kwargs)) + "check_external_database_connector_connection_status got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalDatabaseConnectorId": external_database_connector_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -1807,24 +1892,36 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de self.base_client.call_api, resource_path=resource_path, method=method, - header_params=header_params, - body=create_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup") + path_params=path_params, + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, - header_params=header_params, - body=create_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup") + path_params=path_params, + header_params=header_params) - def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **kwargs): + def complete_external_backup_job(self, backup_id, complete_external_backup_job_details, **kwargs): """ - Creates an Autonomous VM cluster for Exadata Cloud@Customer. + Changes the status of the standalone backup resource to `ACTIVE` after the backup is created from the on-premises database and placed in Oracle Cloud Infrastructure Object Storage. + **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. - :param oci.database.models.CreateAutonomousVmClusterDetails create_autonomous_vm_cluster_details: (required) - Request to create an Autonomous VM cluster. + __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm + + + :param str backup_id: (required) + The backup `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CompleteExternalBackupJobDetails complete_external_backup_job_details: (required) + Updates the status of the backup resource. + + :param str if_match: (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. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1833,9 +1930,6 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1844,31 +1938,41 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use complete_external_backup_job API. """ - resource_path = "/autonomousVmClusters" + resource_path = "/externalBackupJobs/{backupId}/actions/complete" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token", - "opc_request_id" + "if_match", + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "complete_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "backupId": backup_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -1883,24 +1987,26 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster") + body=complete_external_backup_job_details, + response_type="ExternalBackupJob") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster") + body=complete_external_backup_job_details, + response_type="ExternalBackupJob") - def create_backup(self, create_backup_details, **kwargs): + def create_autonomous_container_database(self, create_autonomous_container_database_details, **kwargs): """ - Creates a new backup in the specified database based on the request parameters you provide. If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. + Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure. - :param oci.database.models.CreateBackupDetails create_backup_details: (required) - Request to create a new database backup. + :param oci.database.models.CreateAutonomousContainerDatabaseDetails create_autonomous_container_database_details: (required) + Request to create an Autonomous Container Database in a specified Autonomous Exadata Infrastructure. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1917,13 +2023,13 @@ def create_backup(self, create_backup_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Backup` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_backup API. + Click `here `__ to see an example of how to use create_autonomous_container_database API. """ - resource_path = "/backups" + resource_path = "/autonomousContainerDatabases" method = "POST" # Don't accept unknown kwargs @@ -1934,7 +2040,7 @@ def create_backup(self, create_backup_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_backup got unknown kwargs: {!r}".format(extra_kwargs)) + "create_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -1955,23 +2061,23 @@ def create_backup(self, create_backup_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_backup_details, - response_type="Backup") + body=create_autonomous_container_database_details, + response_type="AutonomousContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_backup_details, - response_type="Backup") + body=create_autonomous_container_database_details, + response_type="AutonomousContainerDatabase") - def create_backup_destination(self, create_backup_destination_details, **kwargs): + def create_autonomous_database(self, create_autonomous_database_details, **kwargs): """ - Creates a backup destination in an Exadata Cloud@Customer system. + Creates a new Autonomous Database. - :param oci.database.models.CreateBackupDestinationDetails create_backup_destination_details: (required) - Request to create a new backup destination. + :param oci.database.models.CreateAutonomousDatabaseBase create_autonomous_database_details: (required) + Request to create a new Autonomous Database. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -1991,13 +2097,13 @@ def create_backup_destination(self, create_backup_destination_details, **kwargs) To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_backup_destination API. + Click `here `__ to see an example of how to use create_autonomous_database API. """ - resource_path = "/backupDestinations" + resource_path = "/autonomousDatabases" method = "POST" # Don't accept unknown kwargs @@ -2009,7 +2115,7 @@ def create_backup_destination(self, create_backup_destination_details, **kwargs) extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) + "create_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2031,27 +2137,23 @@ def create_backup_destination(self, create_backup_destination_details, **kwargs) resource_path=resource_path, method=method, header_params=header_params, - body=create_backup_destination_details, - response_type="BackupDestination") + body=create_autonomous_database_details, + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_backup_destination_details, - response_type="BackupDestination") + body=create_autonomous_database_details, + response_type="AutonomousDatabase") - def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructure_details, **kwargs): + def create_autonomous_database_backup(self, create_autonomous_database_backup_details, **kwargs): """ - Creates a cloud Exadata infrastructure resource. This resource is used to create an `Exadata Cloud Service`__ instance. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/exaoverview.htm - + Creates a new Autonomous Database backup for the specified database based on the provided request parameters. - :param oci.database.models.CreateCloudExadataInfrastructureDetails create_cloud_exadata_infrastructure_details: (required) - Request to create a cloud Exadata infrastructure resource in an `Exadata Cloud Service`__ instance. - __ https://docs.cloud.oracle.com/Content/Database/Concepts/exaoverview.htm + :param oci.database.models.CreateAutonomousDatabaseBackupDetails create_autonomous_database_backup_details: (required) + Request to create a new Autonomous Database backup. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2071,13 +2173,13 @@ def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructur To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseBackup` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_cloud_exadata_infrastructure API. + Click `here `__ to see an example of how to use create_autonomous_database_backup API. """ - resource_path = "/cloudExadataInfrastructures" + resource_path = "/autonomousDatabaseBackups" method = "POST" # Don't accept unknown kwargs @@ -2089,7 +2191,7 @@ def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructur extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "create_autonomous_database_backup got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2111,25 +2213,23 @@ def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructur resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_exadata_infrastructure_details, - response_type="CloudExadataInfrastructure") + body=create_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_exadata_infrastructure_details, - response_type="CloudExadataInfrastructure") + body=create_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup") - def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): + def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **kwargs): """ - Creates a cloud VM cluster. - + Creates an Autonomous VM cluster for Exadata Cloud@Customer. - :param oci.database.models.CreateCloudVmClusterDetails create_cloud_vm_cluster_details: (required) - Request to create a cloud VM cluster. Applies to Exadata Cloud Service instances only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type. - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + :param oci.database.models.CreateAutonomousVmClusterDetails create_autonomous_vm_cluster_details: (required) + Request to create an Autonomous VM cluster. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2149,13 +2249,13 @@ def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_cloud_vm_cluster API. + Click `here `__ to see an example of how to use create_autonomous_vm_cluster API. """ - resource_path = "/cloudVmClusters" + resource_path = "/autonomousVmClusters" method = "POST" # Don't accept unknown kwargs @@ -2167,7 +2267,7 @@ def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "create_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2189,30 +2289,23 @@ def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_vm_cluster_details, - response_type="CloudVmCluster") + body=create_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_vm_cluster_details, - response_type="CloudVmCluster") + body=create_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster") - def create_console_connection(self, create_console_connection_details, db_node_id, **kwargs): + def create_backup(self, create_backup_details, **kwargs): """ - Creates a new console connection to the specified database node. - After the console connection has been created and is available, - you connect to the console using SSH. - - - :param oci.database.models.CreateConsoleConnectionDetails create_console_connection_details: (required) - Request object for creating an CreateConsoleConnection + Creates a new backup in the specified database based on the request parameters you provide. If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. - :param str db_node_id: (required) - The database node `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateBackupDetails create_backup_details: (required) + Request to create a new database backup. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2229,13 +2322,13 @@ def create_console_connection(self, create_console_connection_details, db_node_i To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleConnection` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Backup` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_console_connection API. + Click `here `__ to see an example of how to use create_backup API. """ - resource_path = "/dbNodes/{dbNodeId}/consoleConnections" + resource_path = "/backups" method = "POST" # Don't accept unknown kwargs @@ -2246,17 +2339,7 @@ def create_console_connection(self, create_console_connection_details, db_node_i extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "dbNodeId": db_node_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_backup got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2276,41 +2359,24 @@ def create_console_connection(self, create_console_connection_details, db_node_i self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_console_connection_details, - response_type="ConsoleConnection") + body=create_backup_details, + response_type="Backup") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_console_connection_details, - response_type="ConsoleConnection") + body=create_backup_details, + response_type="Backup") - def create_data_guard_association(self, database_id, create_data_guard_association_details, **kwargs): + def create_backup_destination(self, create_backup_destination_details, **kwargs): """ - Creates a new Data Guard association. A Data Guard association represents the replication relationship between the - specified database and a peer database. For more information, see `Using Oracle Data Guard`__. - - All Oracle Cloud Infrastructure resources, including Data Guard associations, get an Oracle-assigned, unique ID - called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. - You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the - resource in the Console. For more information, see - `Resource Identifiers`__. - - __ https://docs.cloud.oracle.com/Content/Database/Tasks/usingdataguard.htm - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - - :param str database_id: (required) - The database `OCID`__. + Creates a backup destination in an Exadata Cloud@Customer system. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.CreateDataGuardAssociationDetails create_data_guard_association_details: (required) - A request to create a Data Guard association. + :param oci.database.models.CreateBackupDestinationDetails create_backup_destination_details: (required) + Request to create a new backup destination. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2319,6 +2385,9 @@ def create_data_guard_association(self, database_id, create_data_guard_associati has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2327,39 +2396,31 @@ def create_data_guard_association(self, database_id, create_data_guard_associati To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_data_guard_association API. + Click `here `__ to see an example of how to use create_backup_destination API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations" + resource_path = "/backupDestinations" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token" + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "databaseId": database_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2374,26 +2435,28 @@ def create_data_guard_association(self, database_id, create_data_guard_associati self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_data_guard_association_details, - response_type="DataGuardAssociation") + body=create_backup_destination_details, + response_type="BackupDestination") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_data_guard_association_details, - response_type="DataGuardAssociation") + body=create_backup_destination_details, + response_type="BackupDestination") - def create_database(self, create_new_database_details, **kwargs): + def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructure_details, **kwargs): """ - Creates a new database in the specified Database Home. If the database version is provided, it must match the version of the Database Home. Applies to Exadata and Exadata Cloud@Customer systems. + Creates a cloud Exadata infrastructure resource. This resource is used to create an `Exadata Cloud Service`__ instance. + + __ https://docs.cloud.oracle.com/Content/Database/Concepts/exaoverview.htm - :param oci.database.models.CreateDatabaseBase create_new_database_details: (required) - Request to create a new database. + :param oci.database.models.CreateCloudExadataInfrastructureDetails create_cloud_exadata_infrastructure_details: (required) + Request to create a cloud Exadata infrastructure resource in an `Exadata Cloud Service`__ instance. + + __ https://docs.cloud.oracle.com/Content/Database/Concepts/exaoverview.htm :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2413,13 +2476,13 @@ def create_database(self, create_new_database_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_database API. + Click `here `__ to see an example of how to use create_cloud_exadata_infrastructure API. """ - resource_path = "/databases" + resource_path = "/cloudExadataInfrastructures" method = "POST" # Don't accept unknown kwargs @@ -2431,7 +2494,7 @@ def create_database(self, create_new_database_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_database got unknown kwargs: {!r}".format(extra_kwargs)) + "create_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2453,23 +2516,25 @@ def create_database(self, create_new_database_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_new_database_details, - response_type="Database") + body=create_cloud_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_new_database_details, - response_type="Database") + body=create_cloud_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure") - def create_database_software_image(self, create_database_software_image_details, **kwargs): + def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): """ - create database software image in the specified compartment. + Creates a cloud VM cluster. - :param oci.database.models.CreateDatabaseSoftwareImageDetails create_database_software_image_details: (required) - Request to create database software image. + :param oci.database.models.CreateCloudVmClusterDetails create_cloud_vm_cluster_details: (required) + Request to create a cloud VM cluster. Applies to Exadata Cloud Service instances only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type. + + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2478,6 +2543,9 @@ def create_database_software_image(self, create_database_software_image_details, has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2486,29 +2554,31 @@ def create_database_software_image(self, create_database_software_image_details, To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_database_software_image API. + Click `here `__ to see an example of how to use create_cloud_vm_cluster API. """ - resource_path = "/databaseSoftwareImages" + resource_path = "/cloudVmClusters" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token" + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) + "create_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2524,23 +2594,30 @@ def create_database_software_image(self, create_database_software_image_details, resource_path=resource_path, method=method, header_params=header_params, - body=create_database_software_image_details, - response_type="DatabaseSoftwareImage") + body=create_cloud_vm_cluster_details, + response_type="CloudVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_database_software_image_details, - response_type="DatabaseSoftwareImage") + body=create_cloud_vm_cluster_details, + response_type="CloudVmCluster") - def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): + def create_console_connection(self, create_console_connection_details, db_node_id, **kwargs): """ - Creates a new Database Home in the specified database system based on the request parameters you provide. Applies to bare metal DB systems, Exadata systems, and Exadata Cloud@Customer systems. + Creates a new console connection to the specified database node. + After the console connection has been created and is available, + you connect to the console using SSH. - :param oci.database.models.CreateDbHomeBase create_db_home_with_db_system_id_details: (required) - Request to create a new Database Home. + :param oci.database.models.CreateConsoleConnectionDetails create_console_connection_details: (required) + Request object for creating an CreateConsoleConnection + + :param str db_node_id: (required) + The database node `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2557,13 +2634,13 @@ def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleConnection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_db_home API. + Click `here `__ to see an example of how to use create_console_connection API. """ - resource_path = "/dbHomes" + resource_path = "/dbNodes/{dbNodeId}/consoleConnections" method = "POST" # Don't accept unknown kwargs @@ -2574,7 +2651,17 @@ def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_db_home got unknown kwargs: {!r}".format(extra_kwargs)) + "create_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbNodeId": db_node_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", @@ -2594,25 +2681,41 @@ def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_db_home_with_db_system_id_details, - response_type="DbHome") + body=create_console_connection_details, + response_type="ConsoleConnection") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_db_home_with_db_system_id_details, - response_type="DbHome") + body=create_console_connection_details, + response_type="ConsoleConnection") - def create_exadata_infrastructure(self, create_exadata_infrastructure_details, **kwargs): + def create_data_guard_association(self, database_id, create_data_guard_association_details, **kwargs): """ - Creates an Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. - To create an Exadata Cloud Service infrastructure resource, use the :func:`create_cloud_exadata_infrastructure` operation. + Creates a new Data Guard association. A Data Guard association represents the replication relationship between the + specified database and a peer database. For more information, see `Using Oracle Data Guard`__. + + All Oracle Cloud Infrastructure resources, including Data Guard associations, get an Oracle-assigned, unique ID + called an Oracle Cloud Identifier (OCID). When you create a resource, you can find its OCID in the response. + You can also retrieve a resource's OCID by using a List API operation on that resource type, or by viewing the + resource in the Console. For more information, see + `Resource Identifiers`__. + __ https://docs.cloud.oracle.com/Content/Database/Tasks/usingdataguard.htm + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.CreateExadataInfrastructureDetails create_exadata_infrastructure_details: (required) - Request to create Exadata Cloud@Customer infrastructure. + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CreateDataGuardAssociationDetails create_data_guard_association_details: (required) + A request to create a Data Guard association. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2621,9 +2724,6 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2632,31 +2732,39 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_exadata_infrastructure API. + Click `here `__ to see an example of how to use create_data_guard_association API. """ - resource_path = "/exadataInfrastructures" + resource_path = "/databases/{databaseId}/dataGuardAssociations" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token", - "opc_request_id" + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "create_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "databaseId": database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2671,28 +2779,26 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_exadata_infrastructure_details, - response_type="ExadataInfrastructure") + body=create_data_guard_association_details, + response_type="DataGuardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_exadata_infrastructure_details, - response_type="ExadataInfrastructure") + body=create_data_guard_association_details, + response_type="DataGuardAssociation") - def create_external_backup_job(self, create_external_backup_job_details, **kwargs): + def create_database(self, create_new_database_details, **kwargs): """ - Creates a new backup resource and returns the information the caller needs to back up an on-premises Oracle Database to Oracle Cloud Infrastructure. - - **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. - - __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm + Creates a new database in the specified Database Home. If the database version is provided, it must match the version of the Database Home. Applies to Exadata and Exadata Cloud@Customer systems. - :param oci.database.models.CreateExternalBackupJobDetails create_external_backup_job_details: (required) - Request to create a cloud backup resource for a database running outside the cloud. + :param oci.database.models.CreateDatabaseBase create_new_database_details: (required) + Request to create a new database. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2701,6 +2807,9 @@ def create_external_backup_job(self, create_external_backup_job_details, **kwarg has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2709,29 +2818,31 @@ def create_external_backup_job(self, create_external_backup_job_details, **kwarg To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_external_backup_job API. + Click `here `__ to see an example of how to use create_database API. """ - resource_path = "/externalBackupJobs" + resource_path = "/databases" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token" + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) + "create_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2747,23 +2858,23 @@ def create_external_backup_job(self, create_external_backup_job_details, **kwarg resource_path=resource_path, method=method, header_params=header_params, - body=create_external_backup_job_details, - response_type="ExternalBackupJob") + body=create_new_database_details, + response_type="Database") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_external_backup_job_details, - response_type="ExternalBackupJob") + body=create_new_database_details, + response_type="Database") - def create_key_store(self, create_key_store_details, **kwargs): + def create_database_software_image(self, create_database_software_image_details, **kwargs): """ - Creates a Key Store. + create database software image in the specified compartment. - :param oci.database.models.CreateKeyStoreDetails create_key_store_details: (required) - Request to create a new key store. + :param oci.database.models.CreateDatabaseSoftwareImageDetails create_database_software_image_details: (required) + Request to create database software image. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2772,9 +2883,6 @@ def create_key_store(self, create_key_store_details, **kwargs): has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2783,31 +2891,29 @@ def create_key_store(self, create_key_store_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.KeyStore` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_key_store API. + Click `here `__ to see an example of how to use create_database_software_image API. """ - resource_path = "/keyStores" + resource_path = "/databaseSoftwareImages" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token", - "opc_request_id" + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_key_store got unknown kwargs: {!r}".format(extra_kwargs)) + "create_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2823,24 +2929,23 @@ def create_key_store(self, create_key_store_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_key_store_details, - response_type="KeyStore") + body=create_database_software_image_details, + response_type="DatabaseSoftwareImage") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_key_store_details, - response_type="KeyStore") + body=create_database_software_image_details, + response_type="DatabaseSoftwareImage") - def create_vm_cluster(self, create_vm_cluster_details, **kwargs): + def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): """ - Creates an Exadata Cloud@Customer VM cluster. + Creates a new Database Home in the specified database system based on the request parameters you provide. Applies to bare metal DB systems, Exadata systems, and Exadata Cloud@Customer systems. - :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) - Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. - See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. + :param oci.database.models.CreateDbHomeBase create_db_home_with_db_system_id_details: (required) + Request to create a new Database Home. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2849,9 +2954,6 @@ def create_vm_cluster(self, create_vm_cluster_details, **kwargs): has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -2860,31 +2962,29 @@ def create_vm_cluster(self, create_vm_cluster_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_vm_cluster API. + Click `here `__ to see an example of how to use create_db_home API. """ - resource_path = "/vmClusters" + resource_path = "/dbHomes" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token", - "opc_request_id" + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "create_db_home got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -2900,29 +3000,24 @@ def create_vm_cluster(self, create_vm_cluster_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_vm_cluster_details, - response_type="VmCluster") + body=create_db_home_with_db_system_id_details, + response_type="DbHome") else: return self.base_client.call_api( resource_path=resource_path, method=method, header_params=header_params, - body=create_vm_cluster_details, - response_type="VmCluster") + body=create_db_home_with_db_system_id_details, + response_type="DbHome") - def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_details, **kwargs): + def create_exadata_infrastructure(self, create_exadata_infrastructure_details, **kwargs): """ - Creates the VM cluster network. Applies to Exadata Cloud@Customer instances only. - To create a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`create_cloud_vm_cluster` operation. - - - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + Creates an Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. + To create an Exadata Cloud Service infrastructure resource, use the :func:`create_cloud_exadata_infrastructure` operation. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) - Request to create the Cloud@Customer VM cluster network. + :param oci.database.models.CreateExadataInfrastructureDetails create_exadata_infrastructure_details: (required) + Request to create Exadata Cloud@Customer infrastructure. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -2942,13 +3037,13 @@ def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetwork` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_vm_cluster_network API. + Click `here `__ to see an example of how to use create_exadata_infrastructure API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" + resource_path = "/exadataInfrastructures" method = "POST" # Don't accept unknown kwargs @@ -2960,17 +3055,7 @@ def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "create_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "exadataInfrastructureId": exadata_infrastructure_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", @@ -2991,45 +3076,28 @@ def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=vm_cluster_network_details, - response_type="VmClusterNetwork") + body=create_exadata_infrastructure_details, + response_type="ExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=vm_cluster_network_details, - response_type="VmClusterNetwork") + body=create_exadata_infrastructure_details, + response_type="ExadataInfrastructure") - def db_node_action(self, db_node_id, action, **kwargs): + def create_external_backup_job(self, create_external_backup_job_details, **kwargs): """ - Performs one of the following power actions on the specified DB node: - - start - power on - - stop - power off - - softreset - ACPI shutdown and power on - - reset - power off and power on - - **Note:** Stopping a node affects billing differently, depending on the type of DB system: - *Bare metal and Exadata systems* - The _stop_ state has no effect on the resources you consume. - Billing continues for DB nodes that you stop, and related resources continue - to apply against any relevant quotas. You must terminate the DB system - (:func:`terminate_db_system`) - to remove its resources from billing and quotas. - *Virtual machine DB systems* - Stopping a node stops billing for all OCPUs associated with that node, and billing resumes when you restart the node. - + Creates a new backup resource and returns the information the caller needs to back up an on-premises Oracle Database to Oracle Cloud Infrastructure. - :param str db_node_id: (required) - The database node `OCID`__. + **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm - :param str action: (required) - The action to perform on the DB Node. - Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + :param oci.database.models.CreateExternalBackupJobDetails create_external_backup_job_details: (required) + Request to create a cloud backup resource for a database running outside the cloud. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -3038,11 +3106,6 @@ def db_node_action(self, db_node_id, action, **kwargs): has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str if_match: (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. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3051,46 +3114,29 @@ def db_node_action(self, db_node_id, action, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbNode` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use db_node_action API. + Click `here `__ to see an example of how to use create_external_backup_job API. """ - resource_path = "/dbNodes/{dbNodeId}" + resource_path = "/externalBackupJobs" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token", - "if_match" + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "db_node_action got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "dbNodeId": db_node_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - - query_params = { - "action": action - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + "create_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "if-match": kwargs.get("if_match", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3105,33 +3151,31 @@ def db_node_action(self, db_node_id, action, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="DbNode") + body=create_external_backup_job_details, + response_type="ExternalBackupJob") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="DbNode") + body=create_external_backup_job_details, + response_type="ExternalBackupJob") - def delete_autonomous_database(self, autonomous_database_id, **kwargs): + def create_external_container_database(self, create_external_container_database_details, **kwargs): """ - Deletes the specified Autonomous Database. + Creates a new external container database resource. - :param str autonomous_database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateExternalContainerDatabaseDetails create_external_container_database_details: (required) + Request to create a new external container database resource. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -3144,40 +3188,30 @@ def delete_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_autonomous_database API. + Click `here `__ to see an example of how to use create_external_container_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" - method = "DELETE" + resource_path = "/externalcontainerdatabases" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "autonomousDatabaseId": autonomous_database_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_external_container_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3187,33 +3221,37 @@ def delete_autonomous_database(self, autonomous_database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_container_database_details, + response_type="ExternalContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_container_database_details, + response_type="ExternalContainerDatabase") - def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): + def create_external_database_connector(self, create_external_database_connector_details, **kwargs): """ - Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system. + Creates a new external database connector. - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) + Request to create a connector to an external database. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -3226,40 +3264,30 @@ def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use create_external_database_connector API. """ - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" - method = "DELETE" + resource_path = "/externaldatabaseconnectors" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_external_database_connector got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3269,33 +3297,40 @@ def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_database_connector_details, + response_type="ExternalDatabaseConnector") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_database_connector_details, + response_type="ExternalDatabaseConnector") - def delete_backup(self, backup_id, **kwargs): + def create_external_non_container_database(self, create_external_non_container_database_details, **kwargs): """ - Deletes a full backup. You cannot delete automatic backups using this API. + Creates a new ExternalNonContainerDatabase resource - :param str backup_id: (required) - The backup `OCID`__. + :param oci.database.models.CreateExternalNonContainerDatabaseDetails create_external_non_container_database_details: (required) + Request to create a new external non-container database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_retry_token: (optional) + 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). - :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3305,39 +3340,31 @@ def delete_backup(self, backup_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_backup API. + Click `here `__ to see an example of how to use create_external_non_container_database API. """ - resource_path = "/backups/{backupId}" - method = "DELETE" + resource_path = "/externalnoncontainerdatabases" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_backup got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "backupId": backup_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_external_non_container_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3346,33 +3373,38 @@ def delete_backup(self, backup_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_non_container_database_details, + response_type="ExternalNonContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_non_container_database_details, + response_type="ExternalNonContainerDatabase") - def delete_backup_destination(self, backup_destination_id, **kwargs): + def create_external_pluggable_database(self, create_external_pluggable_database_details, **kwargs): """ - Deletes a backup destination in an Exadata Cloud@Customer system. + Registers a new :func:`create_external_pluggable_database_details` + resource. - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param oci.database.models.CreateExternalPluggableDatabaseDetails create_external_pluggable_database_details: (required) + Request to create a new external pluggable database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -3385,40 +3417,30 @@ def delete_backup_destination(self, backup_destination_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_backup_destination API. + Click `here `__ to see an example of how to use create_external_pluggable_database API. """ - resource_path = "/backupDestinations/{backupDestinationId}" - method = "DELETE" + resource_path = "/externalpluggabledatabases" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "backupDestinationId": backup_destination_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_external_pluggable_database got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3428,36 +3450,37 @@ def delete_backup_destination(self, backup_destination_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_pluggable_database_details, + response_type="ExternalPluggableDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_external_pluggable_database_details, + response_type="ExternalPluggableDatabase") - def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): + def create_key_store(self, create_key_store_details, **kwargs): """ - Deletes the cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. - - - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + Creates a Key Store. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str if_match: (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. + :param oci.database.models.CreateKeyStoreDetails create_key_store_details: (required) + Request to create a new key store. - :param bool is_delete_vm_clusters: (optional) - If `true`, forces the deletion the specified cloud Exadata infrastructure resource as well as all associated VM clusters. If `false`, the cloud Exadata infrastructure resource can be deleted only if it has no associated VM clusters. Default value is `false`. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -3470,46 +3493,30 @@ def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, * To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.KeyStore` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_cloud_exadata_infrastructure API. + Click `here `__ to see an example of how to use create_key_store API. """ - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" - method = "DELETE" + resource_path = "/keyStores" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "is_delete_vm_clusters", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - - query_params = { - "isDeleteVmClusters": kwargs.get("is_delete_vm_clusters", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + "create_key_store got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3519,35 +3526,38 @@ def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, * retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - query_params=query_params, - header_params=header_params) + header_params=header_params, + body=create_key_store_details, + response_type="KeyStore") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - query_params=query_params, - header_params=header_params) + header_params=header_params, + body=create_key_store_details, + response_type="KeyStore") - def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): + def create_vm_cluster(self, create_vm_cluster_details, **kwargs): """ - Deletes the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - + Creates an Exadata Cloud@Customer VM cluster. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) + Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. + See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -3560,40 +3570,30 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_cloud_vm_cluster API. + Click `here `__ to see an example of how to use create_vm_cluster API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}" - method = "DELETE" + resource_path = "/vmClusters" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "cloudVmClusterId": cloud_vm_cluster_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "create_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3603,36 +3603,46 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_vm_cluster_details, + response_type="VmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=create_vm_cluster_details, + response_type="VmCluster") - def delete_console_connection(self, db_node_id, console_connection_id, **kwargs): + def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_details, **kwargs): """ - Deletes the specified database node console connection. + Creates the VM cluster network. Applies to Exadata Cloud@Customer instances only. + To create a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`create_cloud_vm_cluster` operation. - :param str db_node_id: (required) - The database node `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_connection_id: (required) - The OCID of the console connection. + :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) + Request to create the Cloud@Customer VM cluster network. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). + + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3642,28 +3652,28 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetwork` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_console_connection API. + Click `here `__ to see an example of how to use create_vm_cluster_network API. """ - resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" - method = "DELETE" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) + "create_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbNodeId": db_node_id, - "consoleConnectionId": console_connection_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3675,7 +3685,8 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3684,77 +3695,94 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=vm_cluster_network_details, + response_type="VmClusterNetwork") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=vm_cluster_network_details, + response_type="VmClusterNetwork") - def delete_database(self, database_id, **kwargs): + def db_node_action(self, db_node_id, action, **kwargs): """ - Deletes the specified database. Applies only to Exadata systems. + Performs one of the following power actions on the specified DB node: + - start - power on + - stop - power off + - softreset - ACPI shutdown and power on + - reset - power off and power on - The data in this database is local to the Exadata system and will be lost when the database is deleted. Oracle recommends that you back up any data in the Exadata system prior to deleting it. You can use the `performFinalBackup` parameter to have the Exadata system database backed up before it is deleted. + **Note:** Stopping a node affects billing differently, depending on the type of DB system: + *Bare metal and Exadata systems* - The _stop_ state has no effect on the resources you consume. + Billing continues for DB nodes that you stop, and related resources continue + to apply against any relevant quotas. You must terminate the DB system + (:func:`terminate_db_system`) + to remove its resources from billing and quotas. + *Virtual machine DB systems* - Stopping a node stops billing for all OCPUs associated with that node, and billing resumes when you restart the node. - :param str database_id: (required) - The database `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str action: (required) + The action to perform on the DB Node. + + Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + + :param str opc_retry_token: (optional) + 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). + :param str if_match: (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. - :param bool perform_final_backup: (optional) - Whether to perform a final backup of the database or not. Default is false. - - If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. - - This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it. - - :param str opc_request_id: (optional) - Unique identifier for the request. - - :param obj retry_strategy: (optional) - A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbNode` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_database API. + Click `here `__ to see an example of how to use db_node_action API. """ - resource_path = "/databases/{databaseId}" - method = "DELETE" + resource_path = "/dbNodes/{dbNodeId}" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "perform_final_backup", - "opc_request_id" + "opc_retry_token", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_database got unknown kwargs: {!r}".format(extra_kwargs)) + "db_node_action got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "dbNodeId": db_node_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3764,15 +3792,15 @@ def delete_database(self, database_id, **kwargs): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "performFinalBackup": kwargs.get("perform_final_backup", missing) + "action": action } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3781,28 +3809,32 @@ def delete_database(self, database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, query_params=query_params, - header_params=header_params) + header_params=header_params, + response_type="DbNode") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, query_params=query_params, - header_params=header_params) + header_params=header_params, + response_type="DbNode") - def delete_database_software_image(self, database_software_image_id, **kwargs): + def delete_autonomous_database(self, autonomous_database_id, **kwargs): """ - Delete a database software image + Deletes the specified Autonomous Database. - :param str database_software_image_id: (required) - The DB system `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3811,6 +3843,9 @@ def delete_database_software_image(self, database_software_image_id, **kwargs): 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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3823,23 +3858,24 @@ def delete_database_software_image(self, database_software_image_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_database_software_image API. + Click `here `__ to see an example of how to use delete_autonomous_database API. """ - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseSoftwareImageId": database_software_image_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3851,7 +3887,8 @@ def delete_database_software_image(self, database_software_image_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3873,15 +3910,13 @@ def delete_database_software_image(self, database_software_image_id, **kwargs): path_params=path_params, header_params=header_params) - def delete_db_home(self, db_home_id, **kwargs): + def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): """ - Deletes a Database Home. Applies to bare metal DB systems, Exadata Cloud Service, and Exadata Cloud@Customer systems. - - Oracle recommends that you use the `performFinalBackup` parameter to back up any data on a bare metal DB system before you delete a Database Home. On an Exadata Cloud@Customer system or an Exadata Cloud Service system, you can delete a Database Home only when there are no databases in it and therefore you cannot use the `performFinalBackup` parameter to back up data. + Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3890,12 +3925,8 @@ def delete_db_home(self, db_home_id, **kwargs): 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. - :param bool perform_final_backup: (optional) - Whether to perform a final backup of the database or not. Default is false. - - If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. - - This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3909,24 +3940,24 @@ def delete_db_home(self, db_home_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_db_home API. + Click `here `__ to see an example of how to use delete_autonomous_vm_cluster API. """ - resource_path = "/dbHomes/{dbHomeId}" + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "if_match", - "perform_final_backup" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_db_home got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbHomeId": db_home_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3935,15 +3966,11 @@ def delete_db_home(self, db_home_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - query_params = { - "performFinalBackup": kwargs.get("perform_final_backup", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -3957,23 +3984,21 @@ def delete_db_home(self, db_home_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params) - def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): + def delete_backup(self, backup_id, **kwargs): """ - Deletes the Exadata Cloud@Customer infrastructure. + Deletes a full backup. You cannot delete automatic backups using this API. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str backup_id: (required) + The backup `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3982,9 +4007,6 @@ def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): 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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3997,24 +4019,23 @@ def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_exadata_infrastructure API. + Click `here `__ to see an example of how to use delete_backup API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + resource_path = "/backups/{backupId}" method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_backup got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4026,8 +4047,7 @@ def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4049,13 +4069,13 @@ def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): path_params=path_params, header_params=header_params) - def delete_key_store(self, key_store_id, **kwargs): + def delete_backup_destination(self, backup_destination_id, **kwargs): """ - Deletes a key store. + Deletes a backup destination in an Exadata Cloud@Customer system. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -4079,9 +4099,9 @@ def delete_key_store(self, key_store_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_key_store API. + Click `here `__ to see an example of how to use delete_backup_destination API. """ - resource_path = "/keyStores/{keyStoreId}" + resource_path = "/backupDestinations/{backupDestinationId}" method = "DELETE" # Don't accept unknown kwargs @@ -4093,10 +4113,10 @@ def delete_key_store(self, key_store_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_key_store got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "keyStoreId": key_store_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4131,13 +4151,13 @@ def delete_key_store(self, key_store_id, **kwargs): path_params=path_params, header_params=header_params) - def delete_vm_cluster(self, vm_cluster_id, **kwargs): + def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): """ - Deletes the specified VM cluster. Applies to Exadata Cloud@Customer instances only. + Deletes the cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -4146,6 +4166,9 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): 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. + :param bool is_delete_vm_clusters: (optional) + If `true`, forces the deletion the specified cloud Exadata infrastructure resource as well as all associated VM clusters. If `false`, the cloud Exadata infrastructure resource can be deleted only if it has no associated VM clusters. Default value is `false`. + :param str opc_request_id: (optional) Unique identifier for the request. @@ -4161,24 +4184,25 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_vm_cluster API. + Click `here `__ to see an example of how to use delete_cloud_exadata_infrastructure API. """ - resource_path = "/vmClusters/{vmClusterId}" + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "if_match", + "is_delete_vm_clusters", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4187,6 +4211,11 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + query_params = { + "isDeleteVmClusters": kwargs.get("is_delete_vm_clusters", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + header_params = { "accept": "application/json", "content-type": "application/json", @@ -4205,27 +4234,23 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params) - def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): """ - Deletes the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - To delete a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`delete_cloud_vm_cluster` operation. - - - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + Deletes the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -4249,9 +4274,9 @@ def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_vm_cluster_network API. + Click `here `__ to see an example of how to use delete_cloud_vm_cluster API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "DELETE" # Don't accept unknown kwargs @@ -4263,11 +4288,10 @@ def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "delete_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4302,21 +4326,23 @@ def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ path_params=path_params, header_params=header_params) - def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): + def delete_console_connection(self, db_node_id, console_connection_id, **kwargs): """ - Asynchronously deregisters this Autonomous Database with Data Safe. + Deletes the specified database node console connection. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str console_connection_id: (required) + The OCID of the console connection. - :param oci.database.models.DeregisterAutonomousDatabaseDataSafeDetails deregister_autonomous_database_data_safe_details: (optional) - Details for deregistering an Autonomous Database with Data Safe. + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4330,24 +4356,24 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use deregister_autonomous_database_data_safe API. + Click `here `__ to see an example of how to use delete_console_connection API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/deregisterDataSafe" - method = "POST" + resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "deregister_autonomous_database_data_safe_details" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "deregister_autonomous_database_data_safe got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "dbNodeId": db_node_id, + "consoleConnectionId": console_connection_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4359,7 +4385,7 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4373,26 +4399,38 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=kwargs.get('deregister_autonomous_database_data_safe_details')) + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=kwargs.get('deregister_autonomous_database_data_safe_details')) + header_params=header_params) - def disable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): + def delete_database(self, database_id, **kwargs): """ - Disables Operations Insights for the Autonomous Database resource. + Deletes the specified database. Applies only to Exadata systems. + + The data in this database is local to the Exadata system and will be lost when the database is deleted. Oracle recommends that you back up any data in the Exadata system prior to deleting it. You can use the `performFinalBackup` parameter to have the Exadata system database backed up before it is deleted. - :param str autonomous_database_id: (required) + :param str database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str if_match: (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. + + :param bool perform_final_backup: (optional) + Whether to perform a final backup of the database or not. Default is false. + + If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. + + This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it. + :param str opc_request_id: (optional) Unique identifier for the request. @@ -4408,23 +4446,25 @@ def disable_autonomous_database_operations_insights(self, autonomous_database_id :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_autonomous_database_operations_insights API. + Click `here `__ to see an example of how to use delete_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableOperationsInsights" - method = "POST" + resource_path = "/databases/{databaseId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "if_match", + "perform_final_backup", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "disable_autonomous_database_operations_insights got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4433,9 +4473,15 @@ def disable_autonomous_database_operations_insights(self, autonomous_database_id if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + query_params = { + "performFinalBackup": kwargs.get("perform_final_backup", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4450,33 +4496,30 @@ def disable_autonomous_database_operations_insights(self, autonomous_database_id resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params) - def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, **kwargs): + def delete_database_software_image(self, database_software_image_id, **kwargs): """ - Downloads the configuration file for the specified Exadata Cloud@Customer infrastructure. + Delete a database software image - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str database_software_image_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. - - :param str opc_retry_token: (optional) - 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). + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4486,28 +4529,27 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type stream + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use download_exadata_infrastructure_config_file API. + Click `here `__ to see an example of how to use delete_database_software_image API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/downloadConfigFile" - method = "POST" + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "opc_retry_token" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "download_exadata_infrastructure_config_file got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4517,10 +4559,9 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/octet-stream", + "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4529,47 +4570,42 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="stream") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="stream") + header_params=header_params) - def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def delete_db_home(self, db_home_id, **kwargs): """ - Downloads the configuration file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. + Deletes a Database Home. Applies to bare metal DB systems, Exadata Cloud Service, and Exadata Cloud@Customer systems. + Oracle recommends that you use the `performFinalBackup` parameter to back up any data on a bare metal DB system before you delete a Database Home. On an Exadata Cloud@Customer system or an Exadata Cloud Service system, you can delete a Database Home only when there are no databases in it and therefore you cannot use the `performFinalBackup` parameter to back up data. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :param str if_match: (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. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param bool perform_final_backup: (optional) + Whether to perform a final backup of the database or not. Default is false. - :param str opc_request_id: (optional) - Unique identifier for the request. + If you previously used RMAN or dbcli to configure backups and then you switch to using the Console or the API for backups, a new backup configuration is created and associated with your database. This means that you can no longer rely on your previously configured unmanaged backups to work. - :param str opc_retry_token: (optional) - 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). + This parameter is used in multiple APIs. Refer to the API description for details on how the operation uses it. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4579,29 +4615,28 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type stream + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use download_vm_cluster_network_config_file API. + Click `here `__ to see an example of how to use delete_db_home API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadConfigFile" - method = "POST" + resource_path = "/dbHomes/{dbHomeId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "opc_retry_token" + "if_match", + "perform_final_backup" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "download_vm_cluster_network_config_file got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_db_home got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4610,11 +4645,15 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + query_params = { + "performFinalBackup": kwargs.get("perform_final_backup", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + header_params = { - "accept": "application/octet-stream", + "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4623,33 +4662,36 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="stream") + query_params=query_params, + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="stream") + query_params=query_params, + header_params=header_params) - def enable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): + def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): """ - Enables the specified Autonomous Database with Operations Insights. + Deletes the Exadata Cloud@Customer infrastructure. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str if_match: (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. + :param str opc_request_id: (optional) Unique identifier for the request. @@ -4665,23 +4707,24 @@ def enable_autonomous_database_operations_insights(self, autonomous_database_id, :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_autonomous_database_operations_insights API. + Click `here `__ to see an example of how to use delete_exadata_infrastructure API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableOperationsInsights" - method = "POST" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "if_match", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "enable_autonomous_database_operations_insights got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4693,6 +4736,7 @@ def enable_autonomous_database_operations_insights(self, autonomous_database_id, header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4715,31 +4759,26 @@ def enable_autonomous_database_operations_insights(self, autonomous_database_id, path_params=path_params, header_params=header_params) - def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): + def delete_external_container_database(self, external_container_database_id, **kwargs): """ - Initiates a failover the specified Autonomous Database to a standby. + Deletes the :func:`create_external_container_database_details` + resource. Any external pluggable databases registered under this container database must be deleted in + your Oracle Cloud Infrastructure tenancy prior to this operation. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + :param str if_match: (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. - :param str opc_retry_token: (optional) - 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). - - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4748,29 +4787,28 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use fail_over_autonomous_database API. + Click `here `__ to see an example of how to use delete_external_container_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/failover" - method = "POST" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id" + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "fail_over_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_external_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4782,9 +4820,8 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4793,37 +4830,29 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) - def failover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def delete_external_database_connector(self, external_database_connector_id, **kwargs): """ - Fails over the standby Autonomous Container Database identified by the autonomousContainerDatabaseId parameter to the primary Autonomous Container Database after the existing primary Autonomous Container Database fails or becomes unreachable. - - A failover can result in data loss, depending on the protection mode in effect at the time the primary Autonomous Container Database fails. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + Deletes an external database connector. + Any services enabled using the external database connector must be + deleted prior to this operation. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -4832,6 +4861,9 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou 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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4840,28 +4872,28 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use failover_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use delete_external_database_connector API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/failover" - method = "POST" + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "failover_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_external_database_connector got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "externalDatabaseConnectorId": external_database_connector_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4873,7 +4905,8 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4887,43 +4920,32 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) - def failover_data_guard_association(self, database_id, data_guard_association_id, failover_data_guard_association_details, **kwargs): + def delete_external_non_container_database(self, external_non_container_database_id, **kwargs): """ - Performs a failover to transition the standby database identified by the `databaseId` parameter into the - specified Data Guard association's primary role after the existing primary database fails or becomes unreachable. - - A failover might result in data loss depending on the protection mode in effect at the time of the primary - database failure. - - - :param str database_id: (required) - The database `OCID`__. + Deletes the Oracle Cloud Infrastructure resource representing an external non-container database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) - A request to perform a failover, transitioning a standby database into a primary database. - :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4932,28 +4954,28 @@ def failover_data_guard_association(self, database_id, data_guard_association_id To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use failover_data_guard_association API. + Click `here `__ to see an example of how to use delete_external_non_container_database API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/failover" - method = "POST" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "failover_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_external_non_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4965,7 +4987,8 @@ def failover_data_guard_association(self, database_id, data_guard_association_id header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4979,40 +5002,32 @@ def failover_data_guard_association(self, database_id, data_guard_association_id resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=failover_data_guard_association_details, - response_type="DataGuardAssociation") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=failover_data_guard_association_details, - response_type="DataGuardAssociation") + header_params=header_params) - def generate_autonomous_database_wallet(self, autonomous_database_id, generate_autonomous_database_wallet_details, **kwargs): + def delete_external_pluggable_database(self, external_pluggable_database_id, **kwargs): """ - Creates and downloads a wallet for the specified Autonomous Database. + Deletes the :func:`create_external_pluggable_database_details`. + resource. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.GenerateAutonomousDatabaseWalletDetails generate_autonomous_database_wallet_details: (required) - Request to create a new Autonomous Database wallet. - :param str opc_request_id: (optional) Unique identifier for the request. - :param str opc_retry_token: (optional) - 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). + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5022,28 +5037,28 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type stream + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use generate_autonomous_database_wallet API. + Click `here `__ to see an example of how to use delete_external_pluggable_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/generateWallet" - method = "POST" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "opc_request_id", - "opc_retry_token" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "generate_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_external_pluggable_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5053,10 +5068,10 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/octet-stream", + "accept": "application/json", "content-type": "application/json", "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -5065,48 +5080,37 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=generate_autonomous_database_wallet_details, - response_type="stream") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=generate_autonomous_database_wallet_details, - response_type="stream") + header_params=header_params) - def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, generate_recommended_network_details, **kwargs): + def delete_key_store(self, key_store_id, **kwargs): """ - Generates a recommended Cloud@Customer VM cluster network configuration. + Deletes a key store. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str key_store_id: (required) + The `OCID`__ of the key store. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.GenerateRecommendedNetworkDetails generate_recommended_network_details: (required) - Request to generate a recommended Cloud@Customer VM cluster network configuration. + :param str if_match: (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. :param str opc_request_id: (optional) Unique identifier for the request. - :param str opc_retry_token: (optional) - 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). - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5115,28 +5119,28 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetworkDetails` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use generate_recommended_vm_cluster_network API. + Click `here `__ to see an example of how to use delete_key_store API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/actions/generateRecommendedNetwork" - method = "POST" + resource_path = "/keyStores/{keyStoreId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "opc_retry_token" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "generate_recommended_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_key_store got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "keyStoreId": key_store_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5148,8 +5152,8 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -5158,35 +5162,37 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=generate_recommended_network_details, - response_type="VmClusterNetworkDetails") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=generate_recommended_network_details, - response_type="VmClusterNetworkDetails") + header_params=header_params) - def get_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def delete_vm_cluster(self, vm_cluster_id, **kwargs): """ - Gets information about the specified Autonomous Container Database. + Deletes the specified VM cluster. Applies to Exadata Cloud@Customer instances only. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str if_match: (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. + + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5195,23 +5201,28 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_container_database API. + Click `here `__ to see an example of how to use delete_vm_cluster API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" - method = "GET" + resource_path = "/vmClusters/{vmClusterId}" + method = "DELETE" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "if_match", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "vmClusterId": vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5222,8 +5233,11 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -5235,31 +5249,38 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabase") + header_params=header_params) - def get_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): """ - Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database. + Deletes the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. + To delete a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`delete_cloud_vm_cluster` operation. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param str vm_cluster_network_id: (required) + The VM cluster network `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str if_match: (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. + + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5268,24 +5289,29 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use delete_vm_cluster_network API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" - method = "GET" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + method = "DELETE" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "if_match", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "delete_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "exadataInfrastructureId": exadata_infrastructure_id, + "vmClusterNetworkId": vm_cluster_network_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5296,8 +5322,11 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -5309,19 +5338,17 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) - def get_autonomous_database(self, autonomous_database_id, **kwargs): + def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): """ - Gets the details of the specified Autonomous Database. + Asynchronously deregisters this Autonomous Database with Data Safe. :param str autonomous_database_id: (required) @@ -5332,6 +5359,9 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): :param str opc_request_id: (optional) Unique identifier for the request. + :param oci.database.models.DeregisterAutonomousDatabaseDataSafeDetails deregister_autonomous_database_data_safe_details: (optional) + Details for deregistering an Autonomous Database with Data Safe. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5340,24 +5370,25 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_database API. + Click `here `__ to see an example of how to use deregister_autonomous_database_data_safe API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/deregisterDataSafe" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_request_id", + "deregister_autonomous_database_data_safe_details" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "deregister_autonomous_database_data_safe got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { "autonomousDatabaseId": autonomous_database_id @@ -5387,22 +5418,22 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase") + body=kwargs.get('deregister_autonomous_database_data_safe_details')) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase") + body=kwargs.get('deregister_autonomous_database_data_safe_details')) - def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): + def disable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): """ - Gets information about the specified Autonomous Database backup. + Disables Operations Insights for the Autonomous Database resource. - :param str autonomous_database_backup_id: (required) - The `OCID`__ of the Autonomous Database backup. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -5417,14 +5448,14 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseBackup` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_database_backup API. + Click `here `__ to see an example of how to use disable_autonomous_database_operations_insights API. """ - resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableOperationsInsights" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ @@ -5434,10 +5465,10 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_database_backup got unknown kwargs: {!r}".format(extra_kwargs)) + "disable_autonomous_database_operations_insights got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseBackupId": autonomous_database_backup_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5463,34 +5494,39 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseBackup") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseBackup") + header_params=header_params) - def get_autonomous_database_dataguard_association(self, autonomous_database_id, autonomous_database_dataguard_association_id, **kwargs): + def disable_external_container_database_database_management(self, external_container_database_id, **kwargs): """ - Gets an Autonomous Data Guard-enabled database associated with the specified Autonomous Database. + Disable Database Management service for the external container database. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5499,28 +5535,29 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_database_dataguard_association API. + Click `here `__ to see an example of how to use disable_external_container_database_database_management API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations/{autonomousDatabaseDataguardAssociationId}" - method = "GET" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/disableDatabaseManagement" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "disable_external_container_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id, - "autonomousDatabaseDataguardAssociationId": autonomous_database_dataguard_association_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5532,7 +5569,9 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -5541,29 +5580,50 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseDataguardAssociation") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseDataguardAssociation") + header_params=header_params) - def get_autonomous_database_regional_wallet(self, **kwargs): + def disable_external_non_container_database_database_management(self, external_non_container_database_id, **kwargs): """ - Gets the Autonomous Database regional wallet details. + Disable Database Management Service for the external non-container database. + For more information about the Database Management Service, see + `Database Management Service`__. + + __ https://docs.cloud.oracle.com/Content/ExternalDatabase/Concepts/databasemanagementservice.htm + + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5572,29 +5632,43 @@ def get_autonomous_database_regional_wallet(self, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseWallet` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_database_regional_wallet API. + Click `here `__ to see an example of how to use disable_external_non_container_database_database_management API. """ - resource_path = "/autonomousDatabases/wallet" - method = "GET" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableDatabaseManagement" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_database_regional_wallet got unknown kwargs: {!r}".format(extra_kwargs)) + "disable_external_non_container_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalNonContainerDatabaseId": external_non_container_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -5603,32 +5677,50 @@ def get_autonomous_database_regional_wallet(self, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, - header_params=header_params, - response_type="AutonomousDatabaseWallet") + path_params=path_params, + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, - header_params=header_params, - response_type="AutonomousDatabaseWallet") + path_params=path_params, + header_params=header_params) - def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): + def disable_external_pluggable_database_database_management(self, external_pluggable_database_id, **kwargs): """ - Gets the wallet details for the specified Autonomous Database. + Disable Database Management Service for the external pluggable database. + For more information about the Database Management Service, see + `Database Management Service`__. + __ https://docs.cloud.oracle.com/Content/ExternalDatabase/Concepts/databasemanagementservice.htm - :param str autonomous_database_id: (required) - The database `OCID`__. + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_retry_token: (optional) + 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). + :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5637,27 +5729,29 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseWallet` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_database_wallet API. + Click `here `__ to see an example of how to use disable_external_pluggable_database_database_management API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" - method = "GET" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableDatabaseManagement" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) + "disable_external_pluggable_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5669,7 +5763,9 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -5678,31 +5774,41 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseWallet") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabaseWallet") + header_params=header_params) - def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): + def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, **kwargs): """ - Gets information about the specified Autonomous Exadata Infrastructure resource. + Downloads the configuration file for the specified Exadata Cloud@Customer infrastructure. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str opc_retry_token: (optional) + 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). + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5711,23 +5817,28 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type stream :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_exadata_infrastructure API. + Click `here `__ to see an example of how to use download_exadata_infrastructure_config_file API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" - method = "GET" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/downloadConfigFile" + method = "POST" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "opc_retry_token" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "download_exadata_infrastructure_config_file got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5737,40 +5848,60 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/json", - "content-type": "application/json" + "accept": "application/octet-stream", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousExadataInfrastructure") + response_type="stream") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousExadataInfrastructure") + response_type="stream") - def get_autonomous_patch(self, autonomous_patch_id, **kwargs): + def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): """ - Gets information about a specific autonomous patch. + Downloads the configuration file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - :param str autonomous_patch_id: (required) - The autonomous patch `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str vm_cluster_network_id: (required) + The VM cluster network `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str opc_retry_token: (optional) + 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). + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5779,23 +5910,29 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousPatch` + :return: A :class:`~oci.response.Response` object with data of type stream :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_patch API. + Click `here `__ to see an example of how to use download_vm_cluster_network_config_file API. """ - resource_path = "/autonomousPatches/{autonomousPatchId}" - method = "GET" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadConfigFile" + method = "POST" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "opc_retry_token" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_patch got unknown kwargs: {!r}".format(extra_kwargs)) + "download_vm_cluster_network_config_file got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousPatchId": autonomous_patch_id + "exadataInfrastructureId": exadata_infrastructure_id, + "vmClusterNetworkId": vm_cluster_network_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5805,37 +5942,42 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/json", - "content-type": "application/json" + "accept": "application/octet-stream", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousPatch") + response_type="stream") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousPatch") + response_type="stream") - def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): + def enable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): """ - Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system. - + Enables the specified Autonomous Database with Operations Insights. - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -5850,14 +5992,14 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use enable_autonomous_database_operations_insights API. """ - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableOperationsInsights" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ @@ -5867,10 +6009,10 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "enable_autonomous_database_operations_insights got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5896,26 +6038,46 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousVmCluster") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousVmCluster") + header_params=header_params) - def get_backup(self, backup_id, **kwargs): + def enable_external_container_database_database_management(self, external_container_database_id, enable_external_container_database_database_management_details, **kwargs): """ - Gets information about the specified backup. + Enables Database Management Service for the external container database. + For more information about the Database Management Service, see + `Database Management Service`__. + __ https://docs.cloud.oracle.com/Content/ExternalDatabase/Concepts/databasemanagementservice.htm - :param str backup_id: (required) - The backup `OCID`__. + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails enable_external_container_database_database_management_details: (required) + Request to enable the Database Management Service for an external container database. + + :param str opc_retry_token: (optional) + 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). + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5924,23 +6086,29 @@ def get_backup(self, backup_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Backup` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_backup API. + Click `here `__ to see an example of how to use enable_external_container_database_database_management API. """ - resource_path = "/backups/{backupId}" - method = "GET" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/enableDatabaseManagement" + method = "POST" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_retry_token", + "opc_request_id", + "if_match" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_backup got unknown kwargs: {!r}".format(extra_kwargs)) + "enable_external_container_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "backupId": backup_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5951,42 +6119,67 @@ def get_backup(self, backup_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Backup") + body=enable_external_container_database_database_management_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Backup") + body=enable_external_container_database_database_management_details) - def get_backup_destination(self, backup_destination_id, **kwargs): + def enable_external_non_container_database_database_management(self, external_non_container_database_id, enable_external_non_container_database_database_management_details, **kwargs): """ - Gets information about the specified backup destination in an Exadata Cloud@Customer system. + Enable Database Management Service for the external non-container database. + For more information about the Database Management Service, see + `Database Management Service`__. + __ https://docs.cloud.oracle.com/Content/ExternalDatabase/Concepts/databasemanagementservice.htm - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails enable_external_non_container_database_database_management_details: (required) + Request to enable the Database Management Service for an external non-container database. + + :param str opc_retry_token: (optional) + 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). + :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -5995,27 +6188,29 @@ def get_backup_destination(self, backup_destination_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_backup_destination API. + Click `here `__ to see an example of how to use enable_external_non_container_database_database_management API. """ - resource_path = "/backupDestinations/{backupDestinationId}" - method = "GET" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableDatabaseManagement" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) + "enable_external_non_container_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "backupDestinationId": backup_destination_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6027,7 +6222,9 @@ def get_backup_destination(self, backup_destination_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6036,34 +6233,55 @@ def get_backup_destination(self, backup_destination_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="BackupDestination") + body=enable_external_non_container_database_database_management_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="BackupDestination") + body=enable_external_non_container_database_database_management_details) - def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): + def enable_external_pluggable_database_database_management(self, external_pluggable_database_id, enable_external_pluggable_database_database_management_details, **kwargs): """ - Gets information about the specified cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. + Enable Database Management Service for the external pluggable database. + For more information about the Database Management Service, see + `Database Management Service`__. + __ https://docs.cloud.oracle.com/Content/ExternalDatabase/Concepts/databasemanagementservice.htm - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails enable_external_pluggable_database_database_management_details: (required) + Request to enable the Database Management Service for an external database. + + :param str opc_retry_token: (optional) + 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). + :param str opc_request_id: (optional) Unique identifier for the request. + :param str if_match: (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. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6072,27 +6290,29 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_cloud_exadata_infrastructure API. + Click `here `__ to see an example of how to use enable_external_pluggable_database_database_management API. """ - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" - method = "GET" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableDatabaseManagement" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_retry_token", + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "enable_external_pluggable_database_database_management got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6104,7 +6324,9 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6113,31 +6335,45 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="CloudExadataInfrastructure") + body=enable_external_pluggable_database_database_management_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="CloudExadataInfrastructure") + body=enable_external_pluggable_database_database_management_details) - def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): + def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): """ - Gets information about the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. + Initiates a failover the specified Autonomous Database to a standby. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str if_match: (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. + + :param str opc_retry_token: (optional) + 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). + :param str opc_request_id: (optional) Unique identifier for the request. @@ -6149,27 +6385,29 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_cloud_vm_cluster API. + Click `here `__ to see an example of how to use fail_over_autonomous_database API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/failover" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "fail_over_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6181,6 +6419,8 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6190,34 +6430,44 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="CloudVmCluster") + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="CloudVmCluster") + response_type="AutonomousDatabase") - def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): + def failover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Gets the IORM configuration for the specified cloud VM cluster in an Exadata Cloud Service instance. - If you have not specified an IORM configuration, the default configuration is returned. + Fails over the standby Autonomous Container Database identified by the autonomousContainerDatabaseId parameter to the primary Autonomous Container Database after the existing primary Autonomous Container Database fails or becomes unreachable. + + A failover can result in data loss, depending on the protection mode in effect at the time the primary Autonomous Container Database fails. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6227,27 +6477,28 @@ def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_cloud_vm_cluster_iorm_config API. + Click `here `__ to see an example of how to use failover_autonomous_container_database_dataguard_association API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" - method = "GET" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/failover" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_cloud_vm_cluster_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) + "failover_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "autonomousContainerDatabaseId": autonomous_container_database_id, + "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6259,7 +6510,7 @@ def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6274,32 +6525,41 @@ def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadataIormConfig") + response_type="AutonomousContainerDatabaseDataguardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExadataIormConfig") + response_type="AutonomousContainerDatabaseDataguardAssociation") - def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): + def failover_data_guard_association(self, database_id, data_guard_association_id, failover_data_guard_association_details, **kwargs): """ - Gets information about a specified maintenance update package for a cloud VM cluster. Applies to Exadata Cloud Service instances only. + Performs a failover to transition the standby database identified by the `databaseId` parameter into the + specified Data Guard association's primary role after the existing primary database fails or becomes unreachable. + + A failover might result in data loss depending on the protection mode in effect at the time of the primary + database failure. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str update_id: (required) - The `OCID`__ of the maintenance update. + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) + A request to perform a failover, transitioning a standby database into a primary database. + + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6309,28 +6569,28 @@ def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Update` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_cloud_vm_cluster_update API. + Click `here `__ to see an example of how to use failover_data_guard_association API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates/{updateId}" - method = "GET" + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/failover" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_cloud_vm_cluster_update got unknown kwargs: {!r}".format(extra_kwargs)) + "failover_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id, - "updateId": update_id + "databaseId": database_id, + "dataGuardAssociationId": data_guard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6342,7 +6602,7 @@ def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6357,33 +6617,40 @@ def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Update") + body=failover_data_guard_association_details, + response_type="DataGuardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Update") + body=failover_data_guard_association_details, + response_type="DataGuardAssociation") - def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_history_entry_id, **kwargs): + def generate_autonomous_database_wallet(self, autonomous_database_id, generate_autonomous_database_wallet_details, **kwargs): """ - Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud Service instances only. + Creates and downloads a wallet for the specified Autonomous Database. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str update_history_entry_id: (required) - The `OCID`__ of the maintenance update history entry. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.GenerateAutonomousDatabaseWalletDetails generate_autonomous_database_wallet_details: (required) + Request to create a new Autonomous Database wallet. :param str opc_request_id: (optional) Unique identifier for the request. + :param str opc_retry_token: (optional) + 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). + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6392,28 +6659,28 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.UpdateHistoryEntry` + :return: A :class:`~oci.response.Response` object with data of type stream :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_cloud_vm_cluster_update_history_entry API. + Click `here `__ to see an example of how to use generate_autonomous_database_wallet API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/generateWallet" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id" + "opc_request_id", + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_cloud_vm_cluster_update_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + "generate_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id, - "updateHistoryEntryId": update_history_entry_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6423,9 +6690,10 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/json", + "accept": "application/octet-stream", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -6434,33 +6702,47 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="UpdateHistoryEntry") + body=generate_autonomous_database_wallet_details, + response_type="stream") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="UpdateHistoryEntry") + body=generate_autonomous_database_wallet_details, + response_type="stream") - def get_console_connection(self, db_node_id, console_connection_id, **kwargs): + def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, generate_recommended_network_details, **kwargs): """ - Gets the specified database node console connection's information. + Generates a recommended Cloud@Customer VM cluster network configuration. - :param str db_node_id: (required) - The database node `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_connection_id: (required) - The OCID of the console connection. + :param oci.database.models.GenerateRecommendedNetworkDetails generate_recommended_network_details: (required) + Request to generate a recommended Cloud@Customer VM cluster network configuration. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str opc_retry_token: (optional) + 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). :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6470,24 +6752,28 @@ def get_console_connection(self, db_node_id, console_connection_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleConnection` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetworkDetails` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_console_connection API. + Click `here `__ to see an example of how to use generate_recommended_vm_cluster_network API. """ - resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" - method = "GET" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/actions/generateRecommendedNetwork" + method = "POST" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "opc_retry_token" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) + "generate_recommended_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbNodeId": db_node_id, - "consoleConnectionId": console_connection_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6498,41 +6784,43 @@ def get_console_connection(self, db_node_id, console_connection_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleConnection") + body=generate_recommended_network_details, + response_type="VmClusterNetworkDetails") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleConnection") + body=generate_recommended_network_details, + response_type="VmClusterNetworkDetails") - def get_data_guard_association(self, database_id, data_guard_association_id, **kwargs): + def get_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Gets the specified Data Guard association's configuration information. - - - :param str database_id: (required) - The database `OCID`__. + Gets information about the specified Autonomous Container Database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -6544,24 +6832,23 @@ def get_data_guard_association(self, database_id, data_guard_association_id, **k To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_data_guard_association API. + Click `here `__ to see an example of how to use get_autonomous_container_database API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6586,22 +6873,27 @@ def get_data_guard_association(self, database_id, data_guard_association_id, **k method=method, path_params=path_params, header_params=header_params, - response_type="DataGuardAssociation") + response_type="AutonomousContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DataGuardAssociation") + response_type="AutonomousContainerDatabase") - def get_database(self, database_id, **kwargs): + def get_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Gets information about the specified database. + Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database. - :param str database_id: (required) - The database `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -6613,23 +6905,24 @@ def get_database(self, database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_database API. + Click `here `__ to see an example of how to use get_autonomous_container_database_dataguard_association API. """ - resource_path = "/databases/{databaseId}" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_database got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "autonomousContainerDatabaseId": autonomous_container_database_id, + "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6654,25 +6947,28 @@ def get_database(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database") + response_type="AutonomousContainerDatabaseDataguardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Database") + response_type="AutonomousContainerDatabaseDataguardAssociation") - def get_database_software_image(self, database_software_image_id, **kwargs): + def get_autonomous_database(self, autonomous_database_id, **kwargs): """ - Gets information about the specified database software image. + Gets the details of the specified Autonomous Database. - :param str database_software_image_id: (required) - The DB system `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6681,23 +6977,27 @@ def get_database_software_image(self, database_software_image_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_database_software_image API. + Click `here `__ to see an example of how to use get_autonomous_database API. """ - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseSoftwareImageId": database_software_image_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6708,8 +7008,10 @@ def get_database_software_image(self, database_software_image_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -6722,27 +7024,22 @@ def get_database_software_image(self, database_software_image_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DatabaseSoftwareImage") + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DatabaseSoftwareImage") + response_type="AutonomousDatabase") - def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_id, **kwargs): + def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): """ - gets the upgrade history for a specified database. - - - :param str database_id: (required) - The database `OCID`__. + Gets information about the specified Autonomous Database backup. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str upgrade_history_entry_id: (required) - The database upgrade History `OCID`__. + :param str autonomous_database_backup_id: (required) + The `OCID`__ of the Autonomous Database backup. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -6757,13 +7054,13 @@ def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseUpgradeHistoryEntry` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseBackup` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_database_upgrade_history_entry API. + Click `here `__ to see an example of how to use get_autonomous_database_backup API. """ - resource_path = "/databases/{databaseId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" + resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" method = "GET" # Don't accept unknown kwargs @@ -6774,11 +7071,10 @@ def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_database_upgrade_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_database_backup got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id, - "upgradeHistoryEntryId": upgrade_history_entry_id + "autonomousDatabaseBackupId": autonomous_database_backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6805,50 +7101,63 @@ def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_ method=method, path_params=path_params, header_params=header_params, - response_type="DatabaseUpgradeHistoryEntry") + response_type="AutonomousDatabaseBackup") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DatabaseUpgradeHistoryEntry") + response_type="AutonomousDatabaseBackup") - def get_db_home(self, db_home_id, **kwargs): + def get_autonomous_database_dataguard_association(self, autonomous_database_id, autonomous_database_dataguard_association_id, **kwargs): """ - Gets information about the specified Database Home. + Gets an Autonomous Data Guard-enabled database associated with the specified Autonomous Database. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param obj retry_strategy: (optional) - A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. + :param str autonomous_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseDataguardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_home API. + Click `here `__ to see an example of how to use get_autonomous_database_dataguard_association API. """ - resource_path = "/dbHomes/{dbHomeId}" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations/{autonomousDatabaseDataguardAssociationId}" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_home got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbHomeId": db_home_id + "autonomousDatabaseId": autonomous_database_id, + "autonomousDatabaseDataguardAssociationId": autonomous_database_dataguard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -6859,8 +7168,10 @@ def get_db_home(self, db_home_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -6873,29 +7184,22 @@ def get_db_home(self, db_home_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbHome") + response_type="AutonomousDatabaseDataguardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DbHome") + response_type="AutonomousDatabaseDataguardAssociation") - def get_db_home_patch(self, db_home_id, patch_id, **kwargs): + def get_autonomous_database_regional_wallet(self, **kwargs): """ - Gets information about a specified patch package. - - - :param str db_home_id: (required) - The Database Home `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + Gets the Autonomous Database regional wallet details. - :param str patch_id: (required) - The `OCID`__ of the patch. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6905,36 +7209,31 @@ def get_db_home_patch(self, db_home_id, patch_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseWallet` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_home_patch API. + Click `here `__ to see an example of how to use get_autonomous_database_regional_wallet API. """ - resource_path = "/dbHomes/{dbHomeId}/patches/{patchId}" + resource_path = "/autonomousDatabases/wallet" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_home_patch got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "dbHomeId": db_home_id, - "patchId": patch_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "get_autonomous_database_regional_wallet got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -6945,31 +7244,27 @@ def get_db_home_patch(self, db_home_id, patch_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="AutonomousDatabaseWallet") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="AutonomousDatabaseWallet") - def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, **kwargs): + def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): """ - Gets the patch history details for the specified patchHistoryEntryId + Gets the wallet details for the specified Autonomous Database. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str patch_history_entry_id: (required) - The `OCID`__ of the patch history entry. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -6979,24 +7274,27 @@ def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, ** To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseWallet` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_home_patch_history_entry API. + Click `here `__ to see an example of how to use get_autonomous_database_wallet API. """ - resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries/{patchHistoryEntryId}" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_home_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbHomeId": db_home_id, - "patchHistoryEntryId": patch_history_entry_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7007,8 +7305,10 @@ def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, ** header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7021,22 +7321,22 @@ def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, ** method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="AutonomousDatabaseWallet") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="AutonomousDatabaseWallet") - def get_db_node(self, db_node_id, **kwargs): + def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Gets information about the specified database node. + Gets information about the specified Autonomous Exadata Infrastructure resource. - :param str db_node_id: (required) - The database node `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7048,23 +7348,23 @@ def get_db_node(self, db_node_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbNode` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_node API. + Click `here `__ to see an example of how to use get_autonomous_exadata_infrastructure API. """ - resource_path = "/dbNodes/{dbNodeId}" + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_node got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbNodeId": db_node_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7089,29 +7389,22 @@ def get_db_node(self, db_node_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbNode") + response_type="AutonomousExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DbNode") + response_type="AutonomousExadataInfrastructure") - def get_db_system(self, db_system_id, **kwargs): + def get_autonomous_patch(self, autonomous_patch_id, **kwargs): """ - Gets information about the specified DB system. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Gets information about a specific autonomous patch. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str autonomous_patch_id: (required) + The autonomous patch `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7123,23 +7416,23 @@ def get_db_system(self, db_system_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousPatch` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_system API. + Click `here `__ to see an example of how to use get_autonomous_patch API. """ - resource_path = "/dbSystems/{dbSystemId}" + resource_path = "/autonomousPatches/{autonomousPatchId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_patch got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "autonomousPatchId": autonomous_patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7164,29 +7457,27 @@ def get_db_system(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbSystem") + response_type="AutonomousPatch") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="DbSystem") + response_type="AutonomousPatch") - def get_db_system_patch(self, db_system_id, patch_id, **kwargs): + def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): """ - Gets information the specified patch. + Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str patch_id: (required) - The `OCID`__ of the patch. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -7196,24 +7487,27 @@ def get_db_system_patch(self, db_system_id, patch_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_system_patch API. + Click `here `__ to see an example of how to use get_autonomous_vm_cluster API. """ - resource_path = "/dbSystems/{dbSystemId}/patches/{patchId}" + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_system_patch got unknown kwargs: {!r}".format(extra_kwargs)) + "get_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id, - "patchId": patch_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7224,8 +7518,10 @@ def get_db_system_patch(self, db_system_id, patch_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7238,27 +7534,22 @@ def get_db_system_patch(self, db_system_id, patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="AutonomousVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="AutonomousVmCluster") - def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id, **kwargs): + def get_backup(self, backup_id, **kwargs): """ - Gets the details of the specified patch operation on the specified DB system. - - - :param str db_system_id: (required) - The DB system `OCID`__. + Gets information about the specified backup. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str patch_history_entry_id: (required) - The `OCID`__ of the patch history entry. + :param str backup_id: (required) + The backup `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7270,24 +7561,23 @@ def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Backup` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_db_system_patch_history_entry API. + Click `here `__ to see an example of how to use get_backup API. """ - resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries/{patchHistoryEntryId}" + resource_path = "/backups/{backupId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_db_system_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + "get_backup got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id, - "patchHistoryEntryId": patch_history_entry_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7312,23 +7602,22 @@ def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="Backup") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="Backup") - def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): + def get_backup_destination(self, backup_destination_id, **kwargs): """ - Gets information about the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only. - To get information on an Exadata Cloud Service infrastructure resource, use the :func:`get_cloud_exadata_infrastructure` operation. + Gets information about the specified backup destination in an Exadata Cloud@Customer system. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7343,13 +7632,13 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_exadata_infrastructure API. + Click `here `__ to see an example of how to use get_backup_destination API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + resource_path = "/backupDestinations/{backupDestinationId}" method = "GET" # Don't accept unknown kwargs @@ -7360,10 +7649,10 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "get_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7390,22 +7679,22 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadataInfrastructure") + response_type="BackupDestination") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExadataInfrastructure") + response_type="BackupDestination") - def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, **kwargs): + def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): """ - Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource. + Gets information about the specified cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7420,13 +7709,13 @@ def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OCPUs` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_exadata_infrastructure_ocpus API. + Click `here `__ to see an example of how to use get_cloud_exadata_infrastructure API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/ocpus" + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "GET" # Don't accept unknown kwargs @@ -7437,10 +7726,10 @@ def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_exadata_infrastructure_ocpus got unknown kwargs: {!r}".format(extra_kwargs)) + "get_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7467,33 +7756,22 @@ def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, method=method, path_params=path_params, header_params=header_params, - response_type="OCPUs") + response_type="CloudExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="OCPUs") + response_type="CloudExadataInfrastructure") - def get_exadata_iorm_config(self, db_system_id, **kwargs): + def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): """ - Gets the IORM configuration settings for the specified cloud Exadata DB system. - All Exadata service instances have default IORM settings. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - The :func:`get_cloud_vm_cluster_iorm_config` API is used for this operation with Exadata systems using the - new resource model. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Gets information about the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7508,13 +7786,13 @@ def get_exadata_iorm_config(self, db_system_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_exadata_iorm_config API. + Click `here `__ to see an example of how to use get_cloud_vm_cluster API. """ - resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "GET" # Don't accept unknown kwargs @@ -7525,10 +7803,10 @@ def get_exadata_iorm_config(self, db_system_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_exadata_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) + "get_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7555,29 +7833,29 @@ def get_exadata_iorm_config(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadataIormConfig") + response_type="CloudVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExadataIormConfig") + response_type="CloudVmCluster") - def get_external_backup_job(self, backup_id, **kwargs): + def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): """ - Gets information about the specified external backup job. - - **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. - - __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm + Gets the IORM configuration for the specified cloud VM cluster in an Exadata Cloud Service instance. + If you have not specified an IORM configuration, the default configuration is returned. - :param str backup_id: (required) - The backup `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -7586,23 +7864,27 @@ def get_external_backup_job(self, backup_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_external_backup_job API. + Click `here `__ to see an example of how to use get_cloud_vm_cluster_iorm_config API. """ - resource_path = "/externalBackupJobs/{backupId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) + "get_cloud_vm_cluster_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "backupId": backup_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7613,8 +7895,10 @@ def get_external_backup_job(self, backup_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7627,22 +7911,27 @@ def get_external_backup_job(self, backup_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExternalBackupJob") + response_type="ExadataIormConfig") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExternalBackupJob") + response_type="ExadataIormConfig") - def get_key_store(self, key_store_id, **kwargs): + def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): """ - Gets information about the specified key store. + Gets information about a specified maintenance update package for a cloud VM cluster. Applies to Exadata Cloud Service instances only. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str update_id: (required) + The `OCID`__ of the maintenance update. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7657,13 +7946,13 @@ def get_key_store(self, key_store_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.KeyStore` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Update` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_key_store API. + Click `here `__ to see an example of how to use get_cloud_vm_cluster_update API. """ - resource_path = "/keyStores/{keyStoreId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates/{updateId}" method = "GET" # Don't accept unknown kwargs @@ -7674,10 +7963,11 @@ def get_key_store(self, key_store_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_key_store got unknown kwargs: {!r}".format(extra_kwargs)) + "get_cloud_vm_cluster_update got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "keyStoreId": key_store_id + "cloudVmClusterId": cloud_vm_cluster_id, + "updateId": update_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7704,22 +7994,32 @@ def get_key_store(self, key_store_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="KeyStore") + response_type="Update") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="KeyStore") + response_type="Update") - def get_maintenance_run(self, maintenance_run_id, **kwargs): + def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_history_entry_id, **kwargs): """ - Gets information about the specified maintenance run. + Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud Service instances only. - :param str maintenance_run_id: (required) - The maintenance run OCID. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str update_history_entry_id: (required) + The `OCID`__ of the maintenance update history entry. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -7729,23 +8029,28 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.MaintenanceRun` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.UpdateHistoryEntry` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_maintenance_run API. + Click `here `__ to see an example of how to use get_cloud_vm_cluster_update_history_entry API. """ - resource_path = "/maintenanceRuns/{maintenanceRunId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" method = "GET" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_maintenance_run got unknown kwargs: {!r}".format(extra_kwargs)) + "get_cloud_vm_cluster_update_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "maintenanceRunId": maintenance_run_id + "cloudVmClusterId": cloud_vm_cluster_id, + "updateHistoryEntryId": update_history_entry_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7756,8 +8061,10 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7770,27 +8077,27 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="MaintenanceRun") + response_type="UpdateHistoryEntry") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="MaintenanceRun") + response_type="UpdateHistoryEntry") - def get_vm_cluster(self, vm_cluster_id, **kwargs): + def get_console_connection(self, db_node_id, console_connection_id, **kwargs): """ - Gets information about the VM cluster. Applies to Exadata Cloud@Customer instances only. + Gets the specified database node console connection's information. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str console_connection_id: (required) + The OCID of the console connection. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -7800,27 +8107,24 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleConnection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_vm_cluster API. + Click `here `__ to see an example of how to use get_console_connection API. """ - resource_path = "/vmClusters/{vmClusterId}" + resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" method = "GET" - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "opc_request_id" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "get_console_connection got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id + "dbNodeId": db_node_id, + "consoleConnectionId": console_connection_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7831,10 +8135,8 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7847,34 +8149,30 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="VmCluster") + response_type="ConsoleConnection") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="VmCluster") + response_type="ConsoleConnection") - def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def get_data_guard_association(self, database_id, data_guard_association_id, **kwargs): """ - Gets information about the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - To get information about a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`get_cloud_vm_cluster` operation. + Gets the specified Data Guard association's configuration information. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -7883,28 +8181,24 @@ def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_i To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetwork` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_vm_cluster_network API. + Click `here `__ to see an example of how to use get_data_guard_association API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" method = "GET" - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "opc_request_id" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) + "get_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "databaseId": database_id, + "dataGuardAssociationId": data_guard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -7915,10 +8209,8 @@ def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_i header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -7931,27 +8223,22 @@ def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_i method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterNetwork") + response_type="DataGuardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterNetwork") + response_type="DataGuardAssociation") - def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): + def get_database(self, database_id, **kwargs): """ - Gets information about a specified patch package. - - - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + Gets information about the specified database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str patch_id: (required) - The `OCID`__ of the patch. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -7963,24 +8250,23 @@ def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_vm_cluster_patch API. + Click `here `__ to see an example of how to use get_database API. """ - resource_path = "/vmClusters/{vmClusterId}/patches/{patchId}" + resource_path = "/databases/{databaseId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_vm_cluster_patch got unknown kwargs: {!r}".format(extra_kwargs)) + "get_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id, - "patchId": patch_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -8005,27 +8291,22 @@ def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="Database") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Patch") + response_type="Database") - def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_id, **kwargs): + def get_database_software_image(self, database_software_image_id, **kwargs): """ - Gets the patch history details for the specified patch history entry. - - - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + Gets information about the specified database software image. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str patch_history_entry_id: (required) - The `OCID`__ of the patch history entry. + :param str database_software_image_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -8037,24 +8318,23 @@ def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_vm_cluster_patch_history_entry API. + Click `here `__ to see an example of how to use get_database_software_image API. """ - resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries/{patchHistoryEntryId}" + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" method = "GET" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_vm_cluster_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + "get_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id, - "patchHistoryEntryId": patch_history_entry_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -8079,29 +8359,32 @@ def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_ method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="DatabaseSoftwareImage") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="PatchHistoryEntry") + response_type="DatabaseSoftwareImage") - def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_infrastructure_details, **kwargs): + def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_id, **kwargs): """ - Creates a new Autonomous Exadata Infrastructure in the specified compartment and availability domain. + gets the upgrade history for a specified database. - :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) - Request to create an Autonomous Exadata Infrastructure resource. + :param str database_id: (required) + The database `OCID`__. - :param str opc_retry_token: (optional) - 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). + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str upgrade_history_entry_id: (required) + The database upgrade History `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8111,29 +8394,40 @@ def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_inf To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseUpgradeHistoryEntry` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use launch_autonomous_exadata_infrastructure API. + Click `here `__ to see an example of how to use get_database_upgrade_history_entry API. """ - resource_path = "/autonomousExadataInfrastructures" - method = "POST" + resource_path = "/databases/{databaseId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" + method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_retry_token" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "launch_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "get_database_upgrade_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "databaseId": database_id, + "upgradeHistoryEntryId": upgrade_history_entry_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -8142,58 +8436,30 @@ def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_inf retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=launch_autonomous_exadata_infrastructure_details, - response_type="AutonomousExadataInfrastructure") + response_type="DatabaseUpgradeHistoryEntry") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=launch_autonomous_exadata_infrastructure_details, - response_type="AutonomousExadataInfrastructure") + response_type="DatabaseUpgradeHistoryEntry") - def launch_db_system(self, launch_db_system_details, **kwargs): + def get_db_home(self, db_home_id, **kwargs): """ - Creates a new DB system in the specified compartment and availability domain. The Oracle - Database edition that you specify applies to all the databases on that DB system. The selected edition cannot be changed. - - An initial database is created on the DB system based on the request parameters you provide and some default - options. For detailed information about default options, see `Bare metal and virtual machine DB system default options.`__ - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - Use the :func:`create_cloud_exadata_infrastructure` and :func:`create_cloud_vm_cluster` APIs to provision a new Exadata Cloud Service instance. - - __ https://docs.cloud.oracle.com/Content/Database/Tasks/creatingDBsystem.htm#Default - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm - - - :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) - Request to launch a DB system. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + Gets information about the specified Database Home. - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + :param str db_home_id: (required) + The Database Home `OCID`__. - :param str opc_retry_token: (optional) - 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). + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8203,69 +8469,70 @@ def launch_db_system(self, launch_db_system_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use launch_db_system API. + Click `here `__ to see an example of how to use get_db_home API. """ - resource_path = "/dbSystems" - method = "POST" + resource_path = "/dbHomes/{dbHomeId}" + method = "GET" - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "opc_retry_token" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "launch_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + "get_db_home got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbHomeId": db_home_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=launch_db_system_details, - response_type="DbSystem") + response_type="DbHome") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=launch_db_system_details, - response_type="DbSystem") + response_type="DbHome") - def list_autonomous_container_database_dataguard_associations(self, autonomous_container_database_id, **kwargs): + def get_db_home_patch(self, db_home_id, patch_id, **kwargs): """ - Gets a list of the Autonomous Container Databases with Autonomous Data Guard-enabled associated with the specified Autonomous Container Database. + Gets information about a specified patch package. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param int limit: (optional) - The maximum number of items to return per page. + :param str patch_id: (required) + The `OCID`__ of the patch. - :param str page: (optional) - The pagination token to continue listing from. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8275,28 +8542,24 @@ def list_autonomous_container_database_dataguard_associations(self, autonomous_c To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_container_database_dataguard_associations API. + Click `here `__ to see an example of how to use get_db_home_patch API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" + resource_path = "/dbHomes/{dbHomeId}/patches/{patchId}" method = "GET" - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "limit", - "page" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_container_database_dataguard_associations got unknown kwargs: {!r}".format(extra_kwargs)) + "get_db_home_patch got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "dbHomeId": db_home_id, + "patchId": patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -8305,12 +8568,6 @@ def list_autonomous_container_database_dataguard_associations(self, autonomous_c if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - query_params = { - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - header_params = { "accept": "application/json", "content-type": "application/json" @@ -8326,42 +8583,2900 @@ def list_autonomous_container_database_dataguard_associations(self, autonomous_c resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseDataguardAssociation]") + response_type="Patch") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseDataguardAssociation]") + response_type="Patch") - def list_autonomous_container_databases(self, compartment_id, **kwargs): + def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, **kwargs): """ - Gets a list of the Autonomous Container Databases in the specified compartment. + Gets the patch history details for the specified patchHistoryEntryId - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_exadata_infrastructure_id: (optional) - The Autonomous Exadata Infrastructure `OCID`__. + :param str patch_history_entry_id: (required) + The `OCID`__ of the patch history entry. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_vm_cluster_id: (optional) - The Autonomous VM Cluster `OCID`__. + :param obj retry_strategy: (optional) + A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + This should be one of the strategies available in the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` + is also available. The specifics of the default retry strategy are described `here `__. - :param str infrastructure_type: (optional) - A filter to return only resources that match the given Infrastructure Type. + To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - Allowed values are: "CLOUD", "CLOUD_AT_CUSTOMER" + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_db_home_patch_history_entry API. + """ + resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries/{patchHistoryEntryId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_db_home_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbHomeId": db_home_id, + "patchHistoryEntryId": patch_history_entry_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + + def get_db_node(self, db_node_id, **kwargs): + """ + Gets information about the specified database node. + + + :param str db_node_id: (required) + The database node `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbNode` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_db_node API. + """ + resource_path = "/dbNodes/{dbNodeId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_db_node got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbNodeId": db_node_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DbNode") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DbNode") + + def get_db_system(self, db_system_id, **kwargs): + """ + Gets information about the specified DB system. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_db_system API. + """ + resource_path = "/dbSystems/{dbSystemId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbSystemId": db_system_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DbSystem") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DbSystem") + + def get_db_system_patch(self, db_system_id, patch_id, **kwargs): + """ + Gets information the specified patch. + + + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str patch_id: (required) + The `OCID`__ of the patch. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_db_system_patch API. + """ + resource_path = "/dbSystems/{dbSystemId}/patches/{patchId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_db_system_patch got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbSystemId": db_system_id, + "patchId": patch_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Patch") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Patch") + + def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id, **kwargs): + """ + Gets the details of the specified patch operation on the specified DB system. + + + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str patch_history_entry_id: (required) + The `OCID`__ of the patch history entry. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_db_system_patch_history_entry API. + """ + resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries/{patchHistoryEntryId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_db_system_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbSystemId": db_system_id, + "patchHistoryEntryId": patch_history_entry_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + + def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): + """ + Gets information about the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only. + To get information on an Exadata Cloud Service infrastructure resource, use the :func:`get_cloud_exadata_infrastructure` operation. + + + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_exadata_infrastructure API. + """ + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "exadataInfrastructureId": exadata_infrastructure_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExadataInfrastructure") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExadataInfrastructure") + + def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, **kwargs): + """ + Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource. + + + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OCPUs` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_exadata_infrastructure_ocpus API. + """ + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/ocpus" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_exadata_infrastructure_ocpus got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="OCPUs") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="OCPUs") + + def get_exadata_iorm_config(self, db_system_id, **kwargs): + """ + Gets the IORM configuration settings for the specified cloud Exadata DB system. + All Exadata service instances have default IORM settings. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + The :func:`get_cloud_vm_cluster_iorm_config` API is used for this operation with Exadata systems using the + new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_exadata_iorm_config API. + """ + resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_exadata_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbSystemId": db_system_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExadataIormConfig") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExadataIormConfig") + + def get_external_backup_job(self, backup_id, **kwargs): + """ + Gets information about the specified external backup job. + + **Note:** This API is used by an Oracle Cloud Infrastructure Python script that is packaged with the Oracle Cloud Infrastructure CLI. Oracle recommends that you use the script instead using the API directly. See `Migrating an On-Premises Database to Oracle Cloud Infrastructure by Creating a Backup in the Cloud`__ for more information. + + __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm + + + :param str backup_id: (required) + The backup `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalBackupJob` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_external_backup_job API. + """ + resource_path = "/externalBackupJobs/{backupId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_external_backup_job got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "backupId": backup_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalBackupJob") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalBackupJob") + + def get_external_container_database(self, external_container_database_id, **kwargs): + """ + Gets information about the specified external container database. + + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_external_container_database API. + """ + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_external_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalContainerDatabaseId": external_container_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalContainerDatabase") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalContainerDatabase") + + def get_external_database_connector(self, external_database_connector_id, **kwargs): + """ + Gets information about the specified external database connector. + + + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_external_database_connector API. + """ + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_external_database_connector got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalDatabaseConnectorId": external_database_connector_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalDatabaseConnector") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalDatabaseConnector") + + def get_external_non_container_database(self, external_non_container_database_id, **kwargs): + """ + Gets information about a specific external non-container database. + + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_external_non_container_database API. + """ + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_external_non_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalNonContainerDatabaseId": external_non_container_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalNonContainerDatabase") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalNonContainerDatabase") + + def get_external_pluggable_database(self, external_pluggable_database_id, **kwargs): + """ + Gets information about a specific + :func:`create_external_pluggable_database_details` resource. + + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_external_pluggable_database API. + """ + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_external_pluggable_database got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "externalPluggableDatabaseId": external_pluggable_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalPluggableDatabase") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExternalPluggableDatabase") + + def get_key_store(self, key_store_id, **kwargs): + """ + Gets information about the specified key store. + + + :param str key_store_id: (required) + The `OCID`__ of the key store. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.KeyStore` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_key_store API. + """ + resource_path = "/keyStores/{keyStoreId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_key_store got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "keyStoreId": key_store_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="KeyStore") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="KeyStore") + + def get_maintenance_run(self, maintenance_run_id, **kwargs): + """ + Gets information about the specified maintenance run. + + + :param str maintenance_run_id: (required) + The maintenance run OCID. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.MaintenanceRun` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_maintenance_run API. + """ + resource_path = "/maintenanceRuns/{maintenanceRunId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_maintenance_run got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "maintenanceRunId": maintenance_run_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="MaintenanceRun") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="MaintenanceRun") + + def get_vm_cluster(self, vm_cluster_id, **kwargs): + """ + Gets information about the VM cluster. Applies to Exadata Cloud@Customer instances only. + + + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmCluster` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster API. + """ + resource_path = "/vmClusters/{vmClusterId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "vmClusterId": vm_cluster_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmCluster") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmCluster") + + def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + """ + Gets information about the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. + To get information about a cloud VM cluster in an Exadata Cloud Service instance, use the :func:`get_cloud_vm_cluster` operation. + + + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str vm_cluster_network_id: (required) + The VM cluster network `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterNetwork` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster_network API. + """ + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_vm_cluster_network got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "exadataInfrastructureId": exadata_infrastructure_id, + "vmClusterNetworkId": vm_cluster_network_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmClusterNetwork") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmClusterNetwork") + + def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): + """ + Gets information about a specified patch package. + + + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str patch_id: (required) + The `OCID`__ of the patch. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Patch` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster_patch API. + """ + resource_path = "/vmClusters/{vmClusterId}/patches/{patchId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_vm_cluster_patch got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "vmClusterId": vm_cluster_id, + "patchId": patch_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Patch") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Patch") + + def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_id, **kwargs): + """ + Gets the patch history details for the specified patch history entry. + + + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str patch_history_entry_id: (required) + The `OCID`__ of the patch history entry. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PatchHistoryEntry` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster_patch_history_entry API. + """ + resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries/{patchHistoryEntryId}" + method = "GET" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_vm_cluster_patch_history_entry got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "vmClusterId": vm_cluster_id, + "patchHistoryEntryId": patch_history_entry_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry") + + def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_infrastructure_details, **kwargs): + """ + Creates a new Autonomous Exadata Infrastructure in the specified compartment and availability domain. + + + :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) + Request to create an Autonomous Exadata Infrastructure resource. + + :param str opc_retry_token: (optional) + 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). + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use launch_autonomous_exadata_infrastructure API. + """ + resource_path = "/autonomousExadataInfrastructures" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_retry_token" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "launch_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-retry-token": kwargs.get("opc_retry_token", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + body=launch_autonomous_exadata_infrastructure_details, + response_type="AutonomousExadataInfrastructure") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + body=launch_autonomous_exadata_infrastructure_details, + response_type="AutonomousExadataInfrastructure") + + def launch_db_system(self, launch_db_system_details, **kwargs): + """ + Creates a new DB system in the specified compartment and availability domain. The Oracle + Database edition that you specify applies to all the databases on that DB system. The selected edition cannot be changed. + + An initial database is created on the DB system based on the request parameters you provide and some default + options. For detailed information about default options, see `Bare metal and virtual machine DB system default options.`__ + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + Use the :func:`create_cloud_exadata_infrastructure` and :func:`create_cloud_vm_cluster` APIs to provision a new Exadata Cloud Service instance. + + __ https://docs.cloud.oracle.com/Content/Database/Tasks/creatingDBsystem.htm#Default + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) + Request to launch a DB system. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + :param str opc_retry_token: (optional) + 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). + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use launch_db_system API. + """ + resource_path = "/dbSystems" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_retry_token" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "launch_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-retry-token": kwargs.get("opc_retry_token", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + body=launch_db_system_details, + response_type="DbSystem") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + body=launch_db_system_details, + response_type="DbSystem") + + def list_autonomous_container_database_dataguard_associations(self, autonomous_container_database_id, **kwargs): + """ + Gets a list of the Autonomous Container Databases with Autonomous Data Guard-enabled associated with the specified Autonomous Container Database. + + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_container_database_dataguard_associations API. + """ + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_container_database_dataguard_associations got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "autonomousContainerDatabaseId": autonomous_container_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + query_params = { + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousContainerDatabaseDataguardAssociation]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousContainerDatabaseDataguardAssociation]") + + def list_autonomous_container_databases(self, compartment_id, **kwargs): + """ + Gets a list of the Autonomous Container Databases in the specified compartment. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_exadata_infrastructure_id: (optional) + The Autonomous Exadata Infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_vm_cluster_id: (optional) + The Autonomous VM Cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str infrastructure_type: (optional) + A filter to return only resources that match the given Infrastructure Type. + + Allowed values are: "CLOUD", "CLOUD_AT_CUSTOMER" + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "BACKUP_IN_PROGRESS", "RESTORING", "RESTORE_FAILED", "RESTARTING", "MAINTENANCE_IN_PROGRESS", "ROLE_CHANGE_IN_PROGRESS", "UNAVAILABLE" + + :param str availability_domain: (optional) + A filter to return only resources that match the given availability domain exactly. + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str service_level_agreement_type: (optional) + A filter to return only resources that match the given service-level agreement type exactly. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_container_databases API. + """ + resource_path = "/autonomousContainerDatabases" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "autonomous_exadata_infrastructure_id", + "autonomous_vm_cluster_id", + "infrastructure_type", + "limit", + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "availability_domain", + "display_name", + "service_level_agreement_type" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_container_databases got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'infrastructure_type' in kwargs: + infrastructure_type_allowed_values = ["CLOUD", "CLOUD_AT_CUSTOMER"] + if kwargs['infrastructure_type'] not in infrastructure_type_allowed_values: + raise ValueError( + "Invalid value for `infrastructure_type`, must be one of {0}".format(infrastructure_type_allowed_values) + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "BACKUP_IN_PROGRESS", "RESTORING", "RESTORE_FAILED", "RESTARTING", "MAINTENANCE_IN_PROGRESS", "ROLE_CHANGE_IN_PROGRESS", "UNAVAILABLE"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "autonomousExadataInfrastructureId": kwargs.get("autonomous_exadata_infrastructure_id", missing), + "autonomousVmClusterId": kwargs.get("autonomous_vm_cluster_id", missing), + "infrastructureType": kwargs.get("infrastructure_type", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "availabilityDomain": kwargs.get("availability_domain", missing), + "displayName": kwargs.get("display_name", missing), + "serviceLevelAgreementType": kwargs.get("service_level_agreement_type", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousContainerDatabaseSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousContainerDatabaseSummary]") + + def list_autonomous_database_backups(self, **kwargs): + """ + Gets a list of Autonomous Database backups based on either the `autonomousDatabaseId` or `compartmentId` specified as a query parameter. + + + :param str autonomous_database_id: (optional) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str compartment_id: (optional) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseBackupSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_backups API. + """ + resource_path = "/autonomousDatabaseBackups" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "autonomous_database_id", + "compartment_id", + "limit", + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_database_backups got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + query_params = { + "autonomousDatabaseId": kwargs.get("autonomous_database_id", missing), + "compartmentId": kwargs.get("compartment_id", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseBackupSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseBackupSummary]") + + def list_autonomous_database_clones(self, compartment_id, autonomous_database_id, **kwargs): + """ + Lists the Autonomous Database clones for the specified Autonomous Database. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING" + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "NONE", "TIMECREATED", "DISPLAYNAME" + + :param str clone_type: (optional) + A filter to return only resources that match the given clone type exactly. + + Allowed values are: "REFRESHABLE_CLONE" + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_clones API. + """ + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/clones" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "limit", + "page", + "sort_order", + "display_name", + "lifecycle_state", + "sort_by", + "clone_type" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_database_clones got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "autonomousDatabaseId": autonomous_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["NONE", "TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'clone_type' in kwargs: + clone_type_allowed_values = ["REFRESHABLE_CLONE"] + if kwargs['clone_type'] not in clone_type_allowed_values: + raise ValueError( + "Invalid value for `clone_type`, must be one of {0}".format(clone_type_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "displayName": kwargs.get("display_name", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "sortBy": kwargs.get("sort_by", missing), + "cloneType": kwargs.get("clone_type", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseSummary]") + + def list_autonomous_database_dataguard_associations(self, autonomous_database_id, **kwargs): + """ + Gets a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous Database. + + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseDataguardAssociation` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_dataguard_associations API. + """ + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_database_dataguard_associations got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "autonomousDatabaseId": autonomous_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + query_params = { + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseDataguardAssociation]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseDataguardAssociation]") + + def list_autonomous_databases(self, compartment_id, **kwargs): + """ + Gets a list of Autonomous Databases based on the query parameters specified. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_id: (optional) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str infrastructure_type: (optional) + A filter to return only resources that match the given Infrastructure Type. + + Allowed values are: "CLOUD", "CLOUD_AT_CUSTOMER" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING" + + :param str db_workload: (optional) + A filter to return only autonomous database resources that match the specified workload type. + + Allowed values are: "OLTP", "DW", "AJD", "APEX" + + :param str db_version: (optional) + A filter to return only autonomous database resources that match the specified dbVersion. + + :param bool is_free_tier: (optional) + Filter on the value of the resource's 'isFreeTier' property. A value of `true` returns only Always Free resources. + A value of `false` excludes Always Free resources from the returned results. Omitting this parameter returns both Always Free and paid resources. + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param bool is_refreshable_clone: (optional) + Filter on the value of the resource's 'isRefreshableClone' property. A value of `true` returns only refreshable clones. + A value of `false` excludes refreshable clones from the returned results. Omitting this parameter returns both refreshable clones and databases that are not refreshable clones. + + :param bool is_data_guard_enabled: (optional) + A filter to return only resources that have Data Guard enabled. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_databases API. + """ + resource_path = "/autonomousDatabases" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "autonomous_container_database_id", + "limit", + "page", + "sort_by", + "sort_order", + "infrastructure_type", + "lifecycle_state", + "db_workload", + "db_version", + "is_free_tier", + "display_name", + "opc_request_id", + "is_refreshable_clone", + "is_data_guard_enabled" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_databases got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'infrastructure_type' in kwargs: + infrastructure_type_allowed_values = ["CLOUD", "CLOUD_AT_CUSTOMER"] + if kwargs['infrastructure_type'] not in infrastructure_type_allowed_values: + raise ValueError( + "Invalid value for `infrastructure_type`, must be one of {0}".format(infrastructure_type_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + if 'db_workload' in kwargs: + db_workload_allowed_values = ["OLTP", "DW", "AJD", "APEX"] + if kwargs['db_workload'] not in db_workload_allowed_values: + raise ValueError( + "Invalid value for `db_workload`, must be one of {0}".format(db_workload_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "autonomousContainerDatabaseId": kwargs.get("autonomous_container_database_id", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "infrastructureType": kwargs.get("infrastructure_type", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "dbWorkload": kwargs.get("db_workload", missing), + "dbVersion": kwargs.get("db_version", missing), + "isFreeTier": kwargs.get("is_free_tier", missing), + "displayName": kwargs.get("display_name", missing), + "isRefreshableClone": kwargs.get("is_refreshable_clone", missing), + "isDataGuardEnabled": kwargs.get("is_data_guard_enabled", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseSummary]") + + def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): + """ + Gets a list of supported Autonomous Database versions. Note that preview version software is only available for + databases with `shared Exadata infrastructure`__. + + __ https://docs.cloud.oracle.com/Content/Database/Concepts/adboverview.htm#AEI + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for DBWORKLOAD is ascending. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "DBWORKLOAD" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDbPreviewVersionSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_db_preview_versions API. + """ + resource_path = "/autonomousDbPreviewVersions" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page", + "opc_request_id", + "sort_by", + "sort_order" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_db_preview_versions got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DBWORKLOAD"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDbPreviewVersionSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDbPreviewVersionSummary]") + + def list_autonomous_db_versions(self, compartment_id, **kwargs): + """ + Gets a list of supported Autonomous Database versions. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str db_workload: (optional) + A filter to return only autonomous database resources that match the specified workload type. + + Allowed values are: "OLTP", "DW", "AJD", "APEX" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDbVersionSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_db_versions API. + """ + resource_path = "/autonomousDbVersions" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page", + "opc_request_id", + "db_workload", + "sort_order" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_db_versions got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'db_workload' in kwargs: + db_workload_allowed_values = ["OLTP", "DW", "AJD", "APEX"] + if kwargs['db_workload'] not in db_workload_allowed_values: + raise ValueError( + "Invalid value for `db_workload`, must be one of {0}".format(db_workload_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "dbWorkload": kwargs.get("db_workload", missing), + "sortOrder": kwargs.get("sort_order", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDbVersionSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDbVersionSummary]") + + def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, compartment_id, **kwargs): + """ + Gets a list of the shapes that can be used to launch a new Autonomous Exadata Infrastructure resource. The shape determines resources to allocate (CPU cores, memory and storage). + + + :param str availability_domain: (required) + The name of the Availability Domain. + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousExadataInfrastructureShapeSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_exadata_infrastructure_shapes API. + """ + resource_path = "/autonomousExadataInfrastructureShapes" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_exadata_infrastructure_shapes got unknown kwargs: {!r}".format(extra_kwargs)) + + query_params = { + "availabilityDomain": availability_domain, + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousExadataInfrastructureShapeSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousExadataInfrastructureShapeSummary]") + + def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): + """ + Gets a list of the Autonomous Exadata Infrastructures in the specified compartment. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + + :param str availability_domain: (optional) + A filter to return only resources that match the given availability domain exactly. + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousExadataInfrastructureSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_exadata_infrastructures API. + """ + resource_path = "/autonomousExadataInfrastructures" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "availability_domain", + "display_name" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_autonomous_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "availabilityDomain": kwargs.get("availability_domain", missing), + "displayName": kwargs.get("display_name", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousExadataInfrastructureSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousExadataInfrastructureSummary]") + + def list_autonomous_vm_clusters(self, compartment_id, **kwargs): + """ + Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str exadata_infrastructure_id: (optional) + If provided, filters the results for the given Exadata Infrastructure. :param int limit: (optional) The maximum number of items to return per page. @@ -8372,8 +11487,6 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): :param str sort_by: (optional) The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. - Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) @@ -8384,16 +11497,13 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "BACKUP_IN_PROGRESS", "RESTORING", "RESTORE_FAILED", "RESTARTING", "MAINTENANCE_IN_PROGRESS", "ROLE_CHANGE_IN_PROGRESS", "UNAVAILABLE" - - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" :param str display_name: (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str service_level_agreement_type: (optional) - A filter to return only resources that match the given service-level agreement type exactly. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8403,41 +11513,31 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousVmClusterSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_container_databases API. + Click `here `__ to see an example of how to use list_autonomous_vm_clusters API. """ - resource_path = "/autonomousContainerDatabases" + resource_path = "/autonomousVmClusters" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "autonomous_exadata_infrastructure_id", - "autonomous_vm_cluster_id", - "infrastructure_type", + "exadata_infrastructure_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "availability_domain", "display_name", - "service_level_agreement_type" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_container_databases got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'infrastructure_type' in kwargs: - infrastructure_type_allowed_values = ["CLOUD", "CLOUD_AT_CUSTOMER"] - if kwargs['infrastructure_type'] not in infrastructure_type_allowed_values: - raise ValueError( - "Invalid value for `infrastructure_type`, must be one of {0}".format(infrastructure_type_allowed_values) - ) + "list_autonomous_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -8454,7 +11554,7 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "BACKUP_IN_PROGRESS", "RESTORING", "RESTORE_FAILED", "RESTARTING", "MAINTENANCE_IN_PROGRESS", "ROLE_CHANGE_IN_PROGRESS", "UNAVAILABLE"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -8462,24 +11562,22 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "autonomousExadataInfrastructureId": kwargs.get("autonomous_exadata_infrastructure_id", missing), - "autonomousVmClusterId": kwargs.get("autonomous_vm_cluster_id", missing), - "infrastructureType": kwargs.get("infrastructure_type", missing), + "exadataInfrastructureId": kwargs.get("exadata_infrastructure_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "availabilityDomain": kwargs.get("availability_domain", missing), - "displayName": kwargs.get("display_name", missing), - "serviceLevelAgreementType": kwargs.get("service_level_agreement_type", missing) + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -8492,26 +11590,21 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseSummary]") + response_type="list[AutonomousVmClusterSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseSummary]") + response_type="list[AutonomousVmClusterSummary]") - def list_autonomous_database_backups(self, **kwargs): + def list_backup_destination(self, compartment_id, **kwargs): """ - Gets a list of Autonomous Database backups based on either the `autonomousDatabaseId` or `compartmentId` specified as a query parameter. - - - :param str autonomous_database_id: (optional) - The database `OCID`__. + Gets a list of backup destinations in the specified compartment. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (optional) + :param str compartment_id: (required) The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -8522,28 +11615,97 @@ def list_autonomous_database_backups(self, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + :param str opc_request_id: (optional) + Unique identifier for the request. - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + :param str type: (optional) + A filter to return only resources that match the given type of the Backup Destination. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + :param obj retry_strategy: (optional) + A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). + This should be one of the strategies available in the :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` + is also available. The specifics of the default retry strategy are described `here `__. - Allowed values are: "ASC", "DESC" + To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.BackupDestinationSummary` + :rtype: :class:`~oci.response.Response` - Allowed values are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED" + :example: + Click `here `__ to see an example of how to use list_backup_destination API. + """ + resource_path = "/backupDestinations" + method = "GET" - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "limit", + "page", + "opc_request_id", + "type" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "type": kwargs.get("type", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[BackupDestinationSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[BackupDestinationSummary]") + + def list_backups(self, **kwargs): + """ + Gets a list of backups based on the `databaseId` or `compartmentId` specified. Either one of these query parameters must be provided. + + + :param str database_id: (optional) + The `OCID`__ of the database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str compartment_id: (optional) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param int limit: (optional) + The maximum number of items to return per page. - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str page: (optional) + The pagination token to continue listing from. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8553,72 +11715,40 @@ def list_autonomous_database_backups(self, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseBackupSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.BackupSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_database_backups API. + Click `here `__ to see an example of how to use list_backups API. """ - resource_path = "/autonomousDatabaseBackups" + resource_path = "/backups" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "autonomous_database_id", + "database_id", "compartment_id", "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "opc_request_id" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_database_backups got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) + "list_backups got unknown kwargs: {!r}".format(extra_kwargs)) query_params = { - "autonomousDatabaseId": kwargs.get("autonomous_database_id", missing), + "databaseId": kwargs.get("database_id", missing), "compartmentId": kwargs.get("compartment_id", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -8631,18 +11761,18 @@ def list_autonomous_database_backups(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseBackupSummary]") + response_type="list[BackupSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseBackupSummary]") + response_type="list[BackupSummary]") - def list_autonomous_database_clones(self, compartment_id, autonomous_database_id, **kwargs): + def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): """ - Lists the Autonomous Database clones for the specified Autonomous Database. + Gets a list of the cloud Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud Service instances only. :param str compartment_id: (required) @@ -8650,44 +11780,32 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_database_id: (required) - The database `OCID`__. + :param int limit: (optional) + The maximum number of items to return per page. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str page: (optional) + The pagination token to continue listing from. :param str opc_request_id: (optional) Unique identifier for the request. - :param int limit: (optional) - The maximum number of items to return per page. + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - :param str page: (optional) - The pagination token to continue listing from. + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). Allowed values are: "ASC", "DESC" - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING" - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. - - Allowed values are: "NONE", "TIMECREATED", "DISPLAYNAME" - - :param str clone_type: (optional) - A filter to return only resources that match the given clone type exactly. + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" - Allowed values are: "REFRESHABLE_CLONE" + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8697,41 +11815,37 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.CloudExadataInfrastructureSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_database_clones API. + Click `here `__ to see an example of how to use list_cloud_exadata_infrastructures API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/clones" + resource_path = "/cloudExadataInfrastructures" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", "limit", "page", + "opc_request_id", + "sort_by", "sort_order", - "display_name", "lifecycle_state", - "sort_by", - "clone_type" + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_database_clones got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "autonomousDatabaseId": autonomous_database_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + "list_cloud_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -8741,35 +11855,20 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) ) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["NONE", "TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) - - if 'clone_type' in kwargs: - clone_type_allowed_values = ["REFRESHABLE_CLONE"] - if kwargs['clone_type'] not in clone_type_allowed_values: - raise ValueError( - "Invalid value for `clone_type`, must be one of {0}".format(clone_type_allowed_values) - ) - query_params = { "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), - "displayName": kwargs.get("display_name", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "sortBy": kwargs.get("sort_by", missing), - "cloneType": kwargs.get("clone_type", missing) + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -8789,35 +11888,41 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]") + response_type="list[CloudExadataInfrastructureSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]") + response_type="list[CloudExadataInfrastructureSummary]") - def list_autonomous_database_dataguard_associations(self, autonomous_database_id, **kwargs): + def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kwargs): """ - Gets a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous Database. + Gets the history of the maintenance update actions performed on the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str update_type: (optional) + A filter to return only resources that match the given update type exactly. + + Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" + :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8826,28 +11931,30 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.UpdateHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_database_dataguard_associations API. + Click `here `__ to see an example of how to use list_cloud_vm_cluster_update_history_entries API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "update_type", "limit", - "page" + "page", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_database_dataguard_associations got unknown kwargs: {!r}".format(extra_kwargs)) + "list_cloud_vm_cluster_update_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -8856,7 +11963,15 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'update_type' in kwargs: + update_type_allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] + if kwargs['update_type'] not in update_type_allowed_values: + raise ValueError( + "Invalid value for `update_type`, must be one of {0}".format(update_type_allowed_values) + ) + query_params = { + "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -8864,8 +11979,10 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -8879,7 +11996,7 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseDataguardAssociation]") + response_type="list[UpdateHistoryEntrySummary]") else: return self.base_client.call_api( resource_path=resource_path, @@ -8887,22 +12004,22 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseDataguardAssociation]") + response_type="list[UpdateHistoryEntrySummary]") - def list_autonomous_databases(self, compartment_id, **kwargs): + def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): """ - Gets a list of Autonomous Databases based on the query parameters specified. + Lists the maintenance updates that can be applied to the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_id: (optional) - The Autonomous Container Database `OCID`__. + :param str update_type: (optional) + A filter to return only resources that match the given update type exactly. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" :param int limit: (optional) The maximum number of items to return per page. @@ -8910,53 +12027,9 @@ def list_autonomous_databases(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str infrastructure_type: (optional) - A filter to return only resources that match the given Infrastructure Type. - - Allowed values are: "CLOUD", "CLOUD_AT_CUSTOMER" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING" - - :param str db_workload: (optional) - A filter to return only autonomous database resources that match the specified workload type. - - Allowed values are: "OLTP", "DW", "AJD", "APEX" - - :param str db_version: (optional) - A filter to return only autonomous database resources that match the specified dbVersion. - - :param bool is_free_tier: (optional) - Filter on the value of the resource's 'isFreeTier' property. A value of `true` returns only Always Free resources. - A value of `false` excludes Always Free resources from the returned results. Omitting this parameter returns both Always Free and paid resources. - - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str opc_request_id: (optional) Unique identifier for the request. - :param bool is_refreshable_clone: (optional) - Filter on the value of the resource's 'isRefreshableClone' property. A value of `true` returns only refreshable clones. - A value of `false` excludes refreshable clones from the returned results. Omitting this parameter returns both refreshable clones and databases that are not refreshable clones. - - :param bool is_data_guard_enabled: (optional) - A filter to return only resources that have Data Guard enabled. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -8965,88 +12038,49 @@ def list_autonomous_databases(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.UpdateSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_databases API. + Click `here `__ to see an example of how to use list_cloud_vm_cluster_updates API. """ - resource_path = "/autonomousDatabases" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "autonomous_container_database_id", + "update_type", "limit", "page", - "sort_by", - "sort_order", - "infrastructure_type", - "lifecycle_state", - "db_workload", - "db_version", - "is_free_tier", - "display_name", - "opc_request_id", - "is_refreshable_clone", - "is_data_guard_enabled" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_databases got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) + "list_cloud_vm_cluster_updates got unknown kwargs: {!r}".format(extra_kwargs)) - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + path_params = { + "cloudVmClusterId": cloud_vm_cluster_id + } - if 'infrastructure_type' in kwargs: - infrastructure_type_allowed_values = ["CLOUD", "CLOUD_AT_CUSTOMER"] - if kwargs['infrastructure_type'] not in infrastructure_type_allowed_values: - raise ValueError( - "Invalid value for `infrastructure_type`, must be one of {0}".format(infrastructure_type_allowed_values) - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "UNAVAILABLE", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "SCALE_IN_PROGRESS", "AVAILABLE_NEEDS_ATTENTION", "UPDATING", "MAINTENANCE_IN_PROGRESS", "RESTARTING", "RECREATING", "ROLE_CHANGE_IN_PROGRESS", "UPGRADING"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - if 'db_workload' in kwargs: - db_workload_allowed_values = ["OLTP", "DW", "AJD", "APEX"] - if kwargs['db_workload'] not in db_workload_allowed_values: + if 'update_type' in kwargs: + update_type_allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] + if kwargs['update_type'] not in update_type_allowed_values: raise ValueError( - "Invalid value for `db_workload`, must be one of {0}".format(db_workload_allowed_values) + "Invalid value for `update_type`, must be one of {0}".format(update_type_allowed_values) ) query_params = { - "compartmentId": compartment_id, - "autonomousContainerDatabaseId": kwargs.get("autonomous_container_database_id", missing), + "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "infrastructureType": kwargs.get("infrastructure_type", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "dbWorkload": kwargs.get("db_workload", missing), - "dbVersion": kwargs.get("db_version", missing), - "isFreeTier": kwargs.get("is_free_tier", missing), - "displayName": kwargs.get("display_name", missing), - "isRefreshableClone": kwargs.get("is_refreshable_clone", missing), - "isDataGuardEnabled": kwargs.get("is_data_guard_enabled", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -9066,23 +12100,22 @@ def list_autonomous_databases(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]") + response_type="list[UpdateSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]") + response_type="list[UpdateSummary]") - def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): + def list_cloud_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of supported Autonomous Database versions. Note that preview version software is only available for - databases with `shared Exadata infrastructure`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/adboverview.htm#AEI + Gets a list of the cloud VM clusters in the specified compartment. Applies to Exadata Cloud Service instances only. :param str compartment_id: (required) @@ -9090,27 +12123,36 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str cloud_exadata_infrastructure_id: (optional) + If provided, filters the results for the specified cloud Exadata infrastructure. + :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for DBWORKLOAD is ascending. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - Allowed values are: "DBWORKLOAD" + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). Allowed values are: "ASC", "DESC" + :param str lifecycle_state: (optional) + A filter to return only cloud VM clusters that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9119,31 +12161,34 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDbPreviewVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.CloudVmClusterSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_db_preview_versions API. + Click `here `__ to see an example of how to use list_cloud_vm_clusters API. """ - resource_path = "/autonomousDbPreviewVersions" + resource_path = "/cloudVmClusters" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "cloud_exadata_infrastructure_id", "limit", "page", - "opc_request_id", "sort_by", - "sort_order" + "sort_order", + "lifecycle_state", + "display_name", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_db_preview_versions got unknown kwargs: {!r}".format(extra_kwargs)) + "list_cloud_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["DBWORKLOAD"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -9156,12 +12201,22 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) ) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + query_params = { "compartmentId": compartment_id, + "cloudExadataInfrastructureId": kwargs.get("cloud_exadata_infrastructure_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing) + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -9183,44 +12238,25 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDbPreviewVersionSummary]") + response_type="list[CloudVmClusterSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDbPreviewVersionSummary]") + response_type="list[CloudVmClusterSummary]") - def list_autonomous_db_versions(self, compartment_id, **kwargs): + def list_console_connections(self, db_node_id, **kwargs): """ - Gets a list of supported Autonomous Database versions. + Lists the console connections for the specified database node. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param int limit: (optional) - The maximum number of items to return per page. - - :param str page: (optional) - The pagination token to continue listing from. - - :param str opc_request_id: (optional) - Unique identifier for the request. - - :param str db_workload: (optional) - A filter to return only autonomous database resources that match the specified workload type. - - Allowed values are: "OLTP", "DW", "AJD", "APEX" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9229,58 +12265,35 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDbVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ConsoleConnectionSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_db_versions API. + Click `here `__ to see an example of how to use list_console_connections API. """ - resource_path = "/autonomousDbVersions" + resource_path = "/dbNodes/{dbNodeId}/consoleConnections" method = "GET" - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "limit", - "page", - "opc_request_id", - "db_workload", - "sort_order" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_db_versions got unknown kwargs: {!r}".format(extra_kwargs)) + "list_console_connections got unknown kwargs: {!r}".format(extra_kwargs)) - if 'db_workload' in kwargs: - db_workload_allowed_values = ["OLTP", "DW", "AJD", "APEX"] - if kwargs['db_workload'] not in db_workload_allowed_values: - raise ValueError( - "Invalid value for `db_workload`, must be one of {0}".format(db_workload_allowed_values) - ) + path_params = { + "dbNodeId": db_node_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - query_params = { - "compartmentId": compartment_id, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "dbWorkload": kwargs.get("db_workload", missing), - "sortOrder": kwargs.get("sort_order", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -9291,24 +12304,26 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - query_params=query_params, + path_params=path_params, header_params=header_params, - response_type="list[AutonomousDbVersionSummary]") + response_type="list[ConsoleConnectionSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - query_params=query_params, + path_params=path_params, header_params=header_params, - response_type="list[AutonomousDbVersionSummary]") + response_type="list[ConsoleConnectionSummary]") - def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, compartment_id, **kwargs): + def list_container_database_patches(self, autonomous_container_database_id, compartment_id, **kwargs): """ - Gets a list of the shapes that can be used to launch a new Autonomous Exadata Infrastructure resource. The shape determines resources to allocate (CPU cores, memory and storage). + Lists the patches applicable to the requested container database. - :param str availability_domain: (required) - The name of the Availability Domain. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str compartment_id: (required) The compartment `OCID`__. @@ -9321,9 +12336,6 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9332,41 +12344,47 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousExadataInfrastructureShapeSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousPatchSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_exadata_infrastructure_shapes API. + Click `here `__ to see an example of how to use list_container_database_patches API. """ - resource_path = "/autonomousExadataInfrastructureShapes" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/patches" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page", - "opc_request_id" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_exadata_infrastructure_shapes got unknown kwargs: {!r}".format(extra_kwargs)) + "list_container_database_patches got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "autonomousContainerDatabaseId": autonomous_container_database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "availabilityDomain": availability_domain, - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "compartmentId": compartment_id } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -9377,24 +12395,26 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousExadataInfrastructureShapeSummary]") + response_type="list[AutonomousPatchSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousExadataInfrastructureShapeSummary]") + response_type="list[AutonomousPatchSummary]") - def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): + def list_data_guard_associations(self, database_id, **kwargs): """ - Gets a list of the Autonomous Exadata Infrastructures in the specified compartment. + Lists all Data Guard associations for the specified database. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -9404,29 +12424,6 @@ def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" - - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. - - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9435,61 +12432,39 @@ def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousExadataInfrastructureSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DataGuardAssociationSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_exadata_infrastructures API. + Click `here `__ to see an example of how to use list_data_guard_associations API. """ - resource_path = "/autonomousExadataInfrastructures" + resource_path = "/databases/{databaseId}/dataGuardAssociations" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "availability_domain", - "display_name" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) + "list_data_guard_associations got unknown kwargs: {!r}".format(extra_kwargs)) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) + path_params = { + "databaseId": database_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "availabilityDomain": kwargs.get("availability_domain", missing), - "displayName": kwargs.get("display_name", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -9507,20 +12482,22 @@ def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousExadataInfrastructureSummary]") + response_type="list[DataGuardAssociationSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousExadataInfrastructureSummary]") + response_type="list[DataGuardAssociationSummary]") - def list_autonomous_vm_clusters(self, compartment_id, **kwargs): + def list_database_software_images(self, compartment_id, **kwargs): """ - Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment. + Gets a list of the database software images in the specified compartment. :param str compartment_id: (required) @@ -9528,9 +12505,6 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str exadata_infrastructure_id: (optional) - If provided, filters the results for the given Exadata Infrastructure. - :param int limit: (optional) The maximum number of items to return per page. @@ -9550,13 +12524,23 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + Allowed values are: "PROVISIONING", "AVAILABLE", "DELETING", "DELETED", "FAILED", "TERMINATING", "TERMINATED", "UPDATING" :param str display_name: (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str image_type: (optional) + A filter to return only resources that match the given image type exactly. + + Allowed values are: "GRID_IMAGE", "DATABASE_IMAGE" + + :param str image_shape_family: (optional) + A filter to return only resources that match the given image shape family exactly. + + Allowed values are: "VM_BM_SHAPE", "EXADATA_SHAPE" + + :param bool is_upgrade_supported: (optional) + If provided, filters the results to the set of database versions which are supported for Upgrade. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9566,31 +12550,32 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousVmClusterSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseSoftwareImageSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_vm_clusters API. + Click `here `__ to see an example of how to use list_database_software_images API. """ - resource_path = "/autonomousVmClusters" + resource_path = "/databaseSoftwareImages" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "exadata_infrastructure_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", "display_name", - "opc_request_id" + "image_type", + "image_shape_family", + "is_upgrade_supported" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_autonomous_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) + "list_database_software_images got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -9607,117 +12592,44 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "DELETING", "DELETED", "FAILED", "TERMINATING", "TERMINATED", "UPDATING"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) ) + if 'image_type' in kwargs: + image_type_allowed_values = ["GRID_IMAGE", "DATABASE_IMAGE"] + if kwargs['image_type'] not in image_type_allowed_values: + raise ValueError( + "Invalid value for `image_type`, must be one of {0}".format(image_type_allowed_values) + ) + + if 'image_shape_family' in kwargs: + image_shape_family_allowed_values = ["VM_BM_SHAPE", "EXADATA_SHAPE"] + if kwargs['image_shape_family'] not in image_shape_family_allowed_values: + raise ValueError( + "Invalid value for `image_shape_family`, must be one of {0}".format(image_shape_family_allowed_values) + ) + query_params = { "compartmentId": compartment_id, - "exadataInfrastructureId": kwargs.get("exadata_infrastructure_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - - header_params = { - "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) - } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} - - retry_strategy = self.retry_strategy - if kwargs.get('retry_strategy'): - retry_strategy = kwargs.get('retry_strategy') - - if retry_strategy: - return retry_strategy.make_retrying_call( - self.base_client.call_api, - resource_path=resource_path, - method=method, - query_params=query_params, - header_params=header_params, - response_type="list[AutonomousVmClusterSummary]") - else: - return self.base_client.call_api( - resource_path=resource_path, - method=method, - query_params=query_params, - header_params=header_params, - response_type="list[AutonomousVmClusterSummary]") - - def list_backup_destination(self, compartment_id, **kwargs): - """ - Gets a list of backup destinations in the specified compartment. - - - :param str compartment_id: (required) - The compartment `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param int limit: (optional) - The maximum number of items to return per page. - - :param str page: (optional) - The pagination token to continue listing from. - - :param str opc_request_id: (optional) - Unique identifier for the request. - - :param str type: (optional) - A filter to return only resources that match the given type of the Backup Destination. - - :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. - - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.BackupDestinationSummary` - :rtype: :class:`~oci.response.Response` - - :example: - Click `here `__ to see an example of how to use list_backup_destination API. - """ - resource_path = "/backupDestinations" - method = "GET" - - # Don't accept unknown kwargs - expected_kwargs = [ - "retry_strategy", - "limit", - "page", - "opc_request_id", - "type" - ] - extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] - if extra_kwargs: - raise ValueError( - "list_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) - - query_params = { - "compartmentId": compartment_id, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "type": kwargs.get("type", missing) + "displayName": kwargs.get("display_name", missing), + "imageType": kwargs.get("image_type", missing), + "imageShapeFamily": kwargs.get("image_shape_family", missing), + "isUpgradeSupported": kwargs.get("is_upgrade_supported", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -9730,29 +12642,47 @@ def list_backup_destination(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[BackupDestinationSummary]") + response_type="list[DatabaseSoftwareImageSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[BackupDestinationSummary]") + response_type="list[DatabaseSoftwareImageSummary]") - def list_backups(self, **kwargs): + def list_database_upgrade_history_entries(self, database_id, **kwargs): """ - Gets a list of backups based on the `databaseId` or `compartmentId` specified. Either one of these query parameters must be provided. + Gets the upgrade history for a specified database in a bare metal or virtual machine DB system. - :param str database_id: (optional) - The `OCID`__ of the database. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (optional) - The compartment `OCID`__. + :param str upgrade_action: (optional) + A filter to return only upgradeHistoryEntries that match the specified Upgrade Action. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + Allowed values are: "PRECHECK", "UPGRADE", "ROLLBACK" + + :param str lifecycle_state: (optional) + A filter to return only upgradeHistoryEntries that match the given lifecycle state exactly. + + Allowed values are: "SUCCEEDED", "FAILED", "IN_PROGRESS" + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is ascending. + + Allowed values are: "TIMESTARTED" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str opc_request_id: (optional) + Unique identifier for the request. :param int limit: (optional) The maximum number of items to return per page. @@ -9768,31 +12698,74 @@ def list_backups(self, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.BackupSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseUpgradeHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_backups API. + Click `here `__ to see an example of how to use list_database_upgrade_history_entries API. """ - resource_path = "/backups" + resource_path = "/databases/{databaseId}/upgradeHistoryEntries" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "database_id", - "compartment_id", + "upgrade_action", + "lifecycle_state", + "sort_by", + "sort_order", + "opc_request_id", "limit", "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_backups got unknown kwargs: {!r}".format(extra_kwargs)) + "list_database_upgrade_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "databaseId": database_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + if 'upgrade_action' in kwargs: + upgrade_action_allowed_values = ["PRECHECK", "UPGRADE", "ROLLBACK"] + if kwargs['upgrade_action'] not in upgrade_action_allowed_values: + raise ValueError( + "Invalid value for `upgrade_action`, must be one of {0}".format(upgrade_action_allowed_values) + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["SUCCEEDED", "FAILED", "IN_PROGRESS"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMESTARTED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) query_params = { - "databaseId": kwargs.get("database_id", missing), - "compartmentId": kwargs.get("compartment_id", missing), + "upgradeAction": kwargs.get("upgrade_action", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -9800,8 +12773,10 @@ def list_backups(self, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -9812,20 +12787,22 @@ def list_backups(self, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[BackupSummary]") + response_type="list[DatabaseUpgradeHistoryEntrySummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[BackupSummary]") + response_type="list[DatabaseUpgradeHistoryEntrySummary]") - def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): + def list_databases(self, compartment_id, **kwargs): """ - Gets a list of the cloud Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud Service instances only. + Gets a list of the databases in the specified Database Home. :param str compartment_id: (required) @@ -9833,19 +12810,26 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str db_home_id: (optional) + A Database Home `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str system_id: (optional) + The `OCID`__ of the Exadata DB system that you want to filter the database results by. Applies only to Exadata DB systems. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DBNAME is ascending. The DBNAME sort order is case sensitive. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + Allowed values are: "DBNAME", "TIMECREATED" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -9855,10 +12839,10 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED" - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param str db_name: (optional) + A filter to return only resources that match the entire database name given. The match is not case sensitive. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9868,33 +12852,34 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.CloudExadataInfrastructureSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_cloud_exadata_infrastructures API. + Click `here `__ to see an example of how to use list_databases API. """ - resource_path = "/cloudExadataInfrastructures" + resource_path = "/databases" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "db_home_id", + "system_id", "limit", "page", - "opc_request_id", "sort_by", "sort_order", "lifecycle_state", - "display_name" + "db_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_cloud_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) + "list_databases got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + sort_by_allowed_values = ["DBNAME", "TIMECREATED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -9908,7 +12893,7 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -9916,21 +12901,21 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, + "dbHomeId": kwargs.get("db_home_id", missing), + "systemId": kwargs.get("system_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) + "dbName": kwargs.get("db_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -9943,39 +12928,31 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudExadataInfrastructureSummary]") + response_type="list[DatabaseSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudExadataInfrastructureSummary]") + response_type="list[DatabaseSummary]") - def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kwargs): + def list_db_home_patch_history_entries(self, db_home_id, **kwargs): """ - Gets the history of the maintenance update actions performed on the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. + Lists the history of patch operations on the specified Database Home. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str update_type: (optional) - A filter to return only resources that match the given update type exactly. - - Allowed values are: "GI_UPGRADE", "GI_PATCH" - :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -9984,30 +12961,28 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.UpdateHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_cloud_vm_cluster_update_history_entries API. + Click `here `__ to see an example of how to use list_db_home_patch_history_entries API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries" + resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "update_type", "limit", - "page", - "opc_request_id" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_cloud_vm_cluster_update_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_home_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10016,15 +12991,7 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - if 'update_type' in kwargs: - update_type_allowed_values = ["GI_UPGRADE", "GI_PATCH"] - if kwargs['update_type'] not in update_type_allowed_values: - raise ValueError( - "Invalid value for `update_type`, must be one of {0}".format(update_type_allowed_values) - ) - query_params = { - "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -10032,10 +12999,8 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -10049,7 +13014,7 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[UpdateHistoryEntrySummary]") + response_type="list[PatchHistoryEntrySummary]") else: return self.base_client.call_api( resource_path=resource_path, @@ -10057,32 +13022,24 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[UpdateHistoryEntrySummary]") + response_type="list[PatchHistoryEntrySummary]") - def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): + def list_db_home_patches(self, db_home_id, **kwargs): """ - Lists the maintenance updates that can be applied to the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. + Lists patches applicable to the requested Database Home. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str update_type: (optional) - A filter to return only resources that match the given update type exactly. - - Allowed values are: "GI_UPGRADE", "GI_PATCH" - :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -10091,30 +13048,28 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.UpdateSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_cloud_vm_cluster_updates API. + Click `here `__ to see an example of how to use list_db_home_patches API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates" + resource_path = "/dbHomes/{dbHomeId}/patches" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "update_type", "limit", - "page", - "opc_request_id" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_cloud_vm_cluster_updates got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_home_patches got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10123,15 +13078,7 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - if 'update_type' in kwargs: - update_type_allowed_values = ["GI_UPGRADE", "GI_PATCH"] - if kwargs['update_type'] not in update_type_allowed_values: - raise ValueError( - "Invalid value for `update_type`, must be one of {0}".format(update_type_allowed_values) - ) - query_params = { - "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -10139,10 +13086,8 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -10156,7 +13101,7 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[UpdateSummary]") + response_type="list[PatchSummary]") else: return self.base_client.call_api( resource_path=resource_path, @@ -10164,20 +13109,35 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[UpdateSummary]") + response_type="list[PatchSummary]") + + def list_db_homes(self, compartment_id, **kwargs): + """ + Lists the Database Homes in the specified DB system and compartment. A Database Home is a directory where Oracle Database software is installed. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str db_system_id: (optional) + The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. - def list_cloud_vm_clusters(self, compartment_id, **kwargs): - """ - Gets a list of the cloud VM clusters in the specified compartment. Applies to Exadata Cloud Service instances only. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str vm_cluster_id: (optional) + The `OCID`__ of the VM cluster. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (required) - The compartment `OCID`__. + :param str backup_id: (optional) + The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str cloud_exadata_infrastructure_id: (optional) - If provided, filters the results for the specified cloud Exadata infrastructure. + :param str db_version: (optional) + A filter to return only DB Homes that match the specified dbVersion. :param int limit: (optional) The maximum number of items to return per page. @@ -10196,16 +13156,13 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only cloud VM clusters that match the given lifecycle state exactly. + A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" :param str display_name: (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -10214,31 +13171,33 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.CloudVmClusterSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbHomeSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_cloud_vm_clusters API. + Click `here `__ to see an example of how to use list_db_homes API. """ - resource_path = "/cloudVmClusters" + resource_path = "/dbHomes" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "cloud_exadata_infrastructure_id", + "db_system_id", + "vm_cluster_id", + "backup_id", + "db_version", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "display_name", - "opc_request_id" + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_cloud_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_homes got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -10255,7 +13214,7 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -10263,7 +13222,10 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "cloudExadataInfrastructureId": kwargs.get("cloud_exadata_infrastructure_id", missing), + "dbSystemId": kwargs.get("db_system_id", missing), + "vmClusterId": kwargs.get("vm_cluster_id", missing), + "backupId": kwargs.get("backup_id", missing), + "dbVersion": kwargs.get("db_version", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), @@ -10275,10 +13237,8 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -10291,95 +13251,32 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudVmClusterSummary]") + response_type="list[DbHomeSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudVmClusterSummary]") + response_type="list[DbHomeSummary]") - def list_console_connections(self, db_node_id, **kwargs): + def list_db_nodes(self, compartment_id, **kwargs): """ - Lists the console connections for the specified database node. + Lists the database nodes in the specified DB system and compartment. A database node is a server running database software. - :param str db_node_id: (required) - The database node `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. - - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ConsoleConnectionSummary` - :rtype: :class:`~oci.response.Response` - - :example: - Click `here `__ to see an example of how to use list_console_connections API. - """ - resource_path = "/dbNodes/{dbNodeId}/consoleConnections" - method = "GET" - - expected_kwargs = ["retry_strategy"] - extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] - if extra_kwargs: - raise ValueError( - "list_console_connections got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "dbNodeId": db_node_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - - header_params = { - "accept": "application/json", - "content-type": "application/json" - } - - retry_strategy = self.retry_strategy - if kwargs.get('retry_strategy'): - retry_strategy = kwargs.get('retry_strategy') - - if retry_strategy: - return retry_strategy.make_retrying_call( - self.base_client.call_api, - resource_path=resource_path, - method=method, - path_params=path_params, - header_params=header_params, - response_type="list[ConsoleConnectionSummary]") - else: - return self.base_client.call_api( - resource_path=resource_path, - method=method, - path_params=path_params, - header_params=header_params, - response_type="list[ConsoleConnectionSummary]") - - def list_container_database_patches(self, autonomous_container_database_id, compartment_id, **kwargs): - """ - Lists the patches applicable to the requested container database. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str db_system_id: (optional) + The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (required) - The compartment `OCID`__. + :param str vm_cluster_id: (optional) + The `OCID`__ of the VM cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10389,6 +13286,21 @@ def list_container_database_patches(self, autonomous_container_database_id, comp :param str page: (optional) The pagination token to continue listing from. + :param str sort_by: (optional) + Sort by TIMECREATED. Default order for TIMECREATED is descending. + + Allowed values are: "TIMECREATED" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED" + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -10397,40 +13309,61 @@ def list_container_database_patches(self, autonomous_container_database_id, comp To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousPatchSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbNodeSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_container_database_patches API. + Click `here `__ to see an example of how to use list_db_nodes API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/patches" + resource_path = "/dbNodes" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "db_system_id", + "vm_cluster_id", "limit", - "page" + "page", + "sort_by", + "sort_order", + "lifecycle_state" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_container_database_patches got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_nodes got unknown kwargs: {!r}".format(extra_kwargs)) - path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) query_params = { + "compartmentId": compartment_id, + "dbSystemId": kwargs.get("db_system_id", missing), + "vmClusterId": kwargs.get("vm_cluster_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "compartmentId": compartment_id + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -10448,26 +13381,24 @@ def list_container_database_patches(self, autonomous_container_database_id, comp self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousPatchSummary]") + response_type="list[DbNodeSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousPatchSummary]") + response_type="list[DbNodeSummary]") - def list_data_guard_associations(self, database_id, **kwargs): + def list_db_system_patch_history_entries(self, db_system_id, **kwargs): """ - Lists all Data Guard associations for the specified database. + Gets the history of the patch actions performed on the specified DB system. - :param str database_id: (required) - The database `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10485,13 +13416,13 @@ def list_data_guard_associations(self, database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DataGuardAssociationSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_data_guard_associations API. + Click `here `__ to see an example of how to use list_db_system_patch_history_entries API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations" + resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries" method = "GET" # Don't accept unknown kwargs @@ -10503,10 +13434,10 @@ def list_data_guard_associations(self, database_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_data_guard_associations got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_system_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10538,62 +13469,31 @@ def list_data_guard_associations(self, database_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DataGuardAssociationSummary]") + response_type="list[PatchHistoryEntrySummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, query_params=query_params, - header_params=header_params, - response_type="list[DataGuardAssociationSummary]") - - def list_database_software_images(self, compartment_id, **kwargs): - """ - Gets a list of the database software images in the specified compartment. - - - :param str compartment_id: (required) - The compartment `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param int limit: (optional) - The maximum number of items to return per page. - - :param str page: (optional) - The pagination token to continue listing from. - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "DELETING", "DELETED", "FAILED", "TERMINATING", "TERMINATED", "UPDATING" + header_params=header_params, + response_type="list[PatchHistoryEntrySummary]") - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + def list_db_system_patches(self, db_system_id, **kwargs): + """ + Lists the patches applicable to the specified DB system. - :param str image_type: (optional) - A filter to return only resources that match the given image type exactly. - Allowed values are: "GRID_IMAGE", "DATABASE_IMAGE" + :param str db_system_id: (required) + The DB system `OCID`__. - :param str image_shape_family: (optional) - A filter to return only resources that match the given image shape family exactly. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - Allowed values are: "VM_BM_SHAPE", "EXADATA_SHAPE" + :param int limit: (optional) + The maximum number of items to return per page. - :param bool is_upgrade_supported: (optional) - If provided, filters the results to the set of database versions which are supported for Upgrade. + :param str page: (optional) + The pagination token to continue listing from. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -10603,79 +13503,39 @@ def list_database_software_images(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseSoftwareImageSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_database_software_images API. + Click `here `__ to see an example of how to use list_db_system_patches API. """ - resource_path = "/databaseSoftwareImages" + resource_path = "/dbSystems/{dbSystemId}/patches" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "image_type", - "image_shape_family", - "is_upgrade_supported" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_database_software_images got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + "list_db_system_patches got unknown kwargs: {!r}".format(extra_kwargs)) - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "DELETING", "DELETED", "FAILED", "TERMINATING", "TERMINATED", "UPDATING"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) + path_params = { + "dbSystemId": db_system_id + } - if 'image_type' in kwargs: - image_type_allowed_values = ["GRID_IMAGE", "DATABASE_IMAGE"] - if kwargs['image_type'] not in image_type_allowed_values: - raise ValueError( - "Invalid value for `image_type`, must be one of {0}".format(image_type_allowed_values) - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - if 'image_shape_family' in kwargs: - image_shape_family_allowed_values = ["VM_BM_SHAPE", "EXADATA_SHAPE"] - if kwargs['image_shape_family'] not in image_shape_family_allowed_values: - raise ValueError( - "Invalid value for `image_shape_family`, must be one of {0}".format(image_shape_family_allowed_values) - ) + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing), - "imageType": kwargs.get("image_type", missing), - "imageShapeFamily": kwargs.get("image_shape_family", missing), - "isUpgradeSupported": kwargs.get("is_upgrade_supported", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -10693,49 +13553,31 @@ def list_database_software_images(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSoftwareImageSummary]") + response_type="list[PatchSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSoftwareImageSummary]") + response_type="list[PatchSummary]") - def list_database_upgrade_history_entries(self, database_id, **kwargs): + def list_db_system_shapes(self, compartment_id, **kwargs): """ - Gets the upgrade history for a specified database in a bare metal or virtual machine DB system. + Gets a list of the shapes that can be used to launch a new 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. - :param str database_id: (required) - The database `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str upgrade_action: (optional) - A filter to return only upgradeHistoryEntries that match the specified Upgrade Action. - - Allowed values are: "PRECHECK", "UPGRADE", "ROLLBACK" - - :param str lifecycle_state: (optional) - A filter to return only upgradeHistoryEntries that match the given lifecycle state exactly. - - Allowed values are: "SUCCEEDED", "FAILED", "IN_PROGRESS" - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is ascending. - - Allowed values are: "TIMESTARTED" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str availability_domain: (optional) + The name of the Availability Domain. :param int limit: (optional) The maximum number of items to return per page. @@ -10751,74 +13593,30 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseUpgradeHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemShapeSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_database_upgrade_history_entries API. + Click `here `__ to see an example of how to use list_db_system_shapes API. """ - resource_path = "/databases/{databaseId}/upgradeHistoryEntries" + resource_path = "/dbSystemShapes" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "upgrade_action", - "lifecycle_state", - "sort_by", - "sort_order", - "opc_request_id", + "availability_domain", "limit", "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_database_upgrade_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "databaseId": database_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - - if 'upgrade_action' in kwargs: - upgrade_action_allowed_values = ["PRECHECK", "UPGRADE", "ROLLBACK"] - if kwargs['upgrade_action'] not in upgrade_action_allowed_values: - raise ValueError( - "Invalid value for `upgrade_action`, must be one of {0}".format(upgrade_action_allowed_values) - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["SUCCEEDED", "FAILED", "IN_PROGRESS"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMESTARTED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + "list_db_system_shapes got unknown kwargs: {!r}".format(extra_kwargs)) query_params = { - "upgradeAction": kwargs.get("upgrade_action", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), + "availabilityDomain": kwargs.get("availability_domain", missing), + "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -10826,10 +13624,8 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -10840,36 +13636,31 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DatabaseUpgradeHistoryEntrySummary]") + response_type="list[DbSystemShapeSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DatabaseUpgradeHistoryEntrySummary]") + response_type="list[DbSystemShapeSummary]") - def list_databases(self, compartment_id, **kwargs): + def list_db_systems(self, compartment_id, **kwargs): """ - Gets a list of the databases in the specified Database Home. - + Lists the DB systems in the specified compartment. You can specify a `backupId` to list only the DB systems that support creating a database using this backup in this compartment. - :param str compartment_id: (required) - The compartment `OCID`__. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - :param str db_home_id: (optional) - A Database Home `OCID`__. + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str system_id: (optional) - The `OCID`__ of the Exadata DB system that you want to filter the database results by. Applies only to Exadata DB systems. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10879,10 +13670,17 @@ def list_databases(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. + :param str backup_id: (optional) + The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DBNAME is ascending. The DBNAME sort order is case sensitive. + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - Allowed values are: "DBNAME", "TIMECREATED" + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -10892,10 +13690,13 @@ def list_databases(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MIGRATED", "MAINTENANCE_IN_PROGRESS", "NEEDS_ATTENTION" - :param str db_name: (optional) - A filter to return only resources that match the entire database name given. The match is not case sensitive. + :param str availability_domain: (optional) + A filter to return only resources that match the given availability domain exactly. + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -10905,34 +13706,34 @@ def list_databases(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_databases API. + Click `here `__ to see an example of how to use list_db_systems API. """ - resource_path = "/databases" + resource_path = "/dbSystems" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "db_home_id", - "system_id", "limit", "page", + "backup_id", "sort_by", "sort_order", "lifecycle_state", - "db_name" + "availability_domain", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_databases got unknown kwargs: {!r}".format(extra_kwargs)) + "list_db_systems got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["DBNAME", "TIMECREATED"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -10946,7 +13747,7 @@ def list_databases(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MIGRATED", "MAINTENANCE_IN_PROGRESS", "NEEDS_ATTENTION"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -10954,14 +13755,14 @@ def list_databases(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "dbHomeId": kwargs.get("db_home_id", missing), - "systemId": kwargs.get("system_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), + "backupId": kwargs.get("backup_id", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "dbName": kwargs.get("db_name", missing) + "availabilityDomain": kwargs.get("availability_domain", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -10981,22 +13782,22 @@ def list_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSummary]") + response_type="list[DbSystemSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSummary]") + response_type="list[DbSystemSummary]") - def list_db_home_patch_history_entries(self, db_home_id, **kwargs): + def list_db_versions(self, compartment_id, **kwargs): """ - Lists the history of patch operations on the specified Database Home. + Gets a list of supported Oracle Database versions. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -11006,6 +13807,24 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. + :param str db_system_shape: (optional) + If provided, filters the results to the set of database versions which are supported for the given shape. + + :param str db_system_id: (optional) + The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str storage_management: (optional) + The DB system storage management option. Used to list database versions available for that storage manager. Valid values are: + * ASM - Automatic storage management + * LVM - Logical volume management + + Allowed values are: "ASM", "LVM" + + :param bool is_upgrade_supported: (optional) + If provided, filters the results to the set of database versions which are supported for Upgrade. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11014,39 +13833,45 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbVersionSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_home_patch_history_entries API. + Click `here `__ to see an example of how to use list_db_versions API. """ - resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries" + resource_path = "/dbVersions" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page" + "page", + "db_system_shape", + "db_system_id", + "storage_management", + "is_upgrade_supported" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_home_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "dbHomeId": db_home_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + "list_db_versions got unknown kwargs: {!r}".format(extra_kwargs)) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'storage_management' in kwargs: + storage_management_allowed_values = ["ASM", "LVM"] + if kwargs['storage_management'] not in storage_management_allowed_values: + raise ValueError( + "Invalid value for `storage_management`, must be one of {0}".format(storage_management_allowed_values) + ) query_params = { + "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "dbSystemShape": kwargs.get("db_system_shape", missing), + "dbSystemId": kwargs.get("db_system_id", missing), + "storageManagement": kwargs.get("storage_management", missing), + "isUpgradeSupported": kwargs.get("is_upgrade_supported", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -11064,26 +13889,25 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + response_type="list[DbVersionSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + response_type="list[DbVersionSummary]") - def list_db_home_patches(self, db_home_id, **kwargs): + def list_exadata_infrastructures(self, compartment_id, **kwargs): """ - Lists patches applicable to the requested Database Home. + Lists the Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud@Customer instances only. + To list the Exadata Cloud Service infrastructure resources in a compartment, use the :func:`list_cloud_exadata_infrastructures` operation. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -11093,6 +13917,27 @@ def list_db_home_patches(self, db_home_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11101,46 +13946,69 @@ def list_db_home_patches(self, db_home_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExadataInfrastructureSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_home_patches API. + Click `here `__ to see an example of how to use list_exadata_infrastructures API. """ - resource_path = "/dbHomes/{dbHomeId}/patches" + resource_path = "/exadataInfrastructures" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page" + "page", + "opc_request_id", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_home_patches got unknown kwargs: {!r}".format(extra_kwargs)) + "list_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) - path_params = { - "dbHomeId": db_home_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) query_params = { + "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11151,22 +14019,20 @@ def list_db_home_patches(self, db_home_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="list[ExadataInfrastructureSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="list[ExadataInfrastructureSummary]") - def list_db_homes(self, compartment_id, **kwargs): + def list_external_container_databases(self, compartment_id, **kwargs): """ - Lists the Database Homes in the specified DB system and compartment. A Database Home is a directory where Oracle Database software is installed. + Gets a list of the external container databases in the specified compartment. :param str compartment_id: (required) @@ -11174,23 +14040,8 @@ def list_db_homes(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str db_system_id: (optional) - The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str vm_cluster_id: (optional) - The `OCID`__ of the VM cluster. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str backup_id: (optional) - The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str db_version: (optional) - A filter to return only DB Homes that match the specified dbVersion. + :param str opc_request_id: (optional) + Unique identifier for the request. :param int limit: (optional) The maximum number of items to return per page. @@ -11199,9 +14050,12 @@ def list_db_homes(self, compartment_id, **kwargs): The pagination token to continue listing from. :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + The field to sort by. You can provide one sort order (`sortOrder`). + Default order for TIMECREATED is descending. + Default order for DISPLAYNAME is ascending. + The DISPLAYNAME sort order is case sensitive. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + Allowed values are: "DISPLAYNAME", "TIMECREATED" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -11209,9 +14063,9 @@ def list_db_homes(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. + A filter to return only resources that match the specified lifecycle state. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" :param str display_name: (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive. @@ -11224,22 +14078,19 @@ def list_db_homes(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbHomeSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalContainerDatabaseSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_homes API. + Click `here `__ to see an example of how to use list_external_container_databases API. """ - resource_path = "/dbHomes" + resource_path = "/externalcontainerdatabases" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "db_system_id", - "vm_cluster_id", - "backup_id", - "db_version", + "opc_request_id", "limit", "page", "sort_by", @@ -11250,10 +14101,10 @@ def list_db_homes(self, compartment_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_homes got unknown kwargs: {!r}".format(extra_kwargs)) + "list_external_container_databases got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -11267,7 +14118,7 @@ def list_db_homes(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -11275,10 +14126,6 @@ def list_db_homes(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "dbSystemId": kwargs.get("db_system_id", missing), - "vmClusterId": kwargs.get("vm_cluster_id", missing), - "backupId": kwargs.get("backup_id", missing), - "dbVersion": kwargs.get("db_version", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), @@ -11290,8 +14137,10 @@ def list_db_homes(self, compartment_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11304,18 +14153,18 @@ def list_db_homes(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbHomeSummary]") + response_type="list[ExternalContainerDatabaseSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DbHomeSummary]") + response_type="list[ExternalContainerDatabaseSummary]") - def list_db_nodes(self, compartment_id, **kwargs): + def list_external_database_connectors(self, compartment_id, external_database_id, **kwargs): """ - Lists the database nodes in the specified DB system and compartment. A database node is a server running database software. + Gets a list of the external database connectors in the specified compartment. :param str compartment_id: (required) @@ -11323,15 +14172,13 @@ def list_db_nodes(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str db_system_id: (optional) - The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. + :param str external_database_id: (required) + The `OCID`__ of the external database whose connectors will be listed. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_id: (optional) - The `OCID`__ of the VM cluster. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. :param int limit: (optional) The maximum number of items to return per page. @@ -11340,9 +14187,12 @@ def list_db_nodes(self, compartment_id, **kwargs): The pagination token to continue listing from. :param str sort_by: (optional) - Sort by TIMECREATED. Default order for TIMECREATED is descending. + The field to sort by. You can provide one sort order (`sortOrder`). + Default order for TIMECREATED is descending. + Default order for DISPLAYNAME is ascending. + The DISPLAYNAME sort order is case sensitive. - Allowed values are: "TIMECREATED" + Allowed values are: "DISPLAYNAME", "TIMECREATED" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -11350,9 +14200,12 @@ def list_db_nodes(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. + A filter to return only resources that match the specified lifecycle state. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11362,33 +14215,33 @@ def list_db_nodes(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbNodeSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalDatabaseConnectorSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_nodes API. + Click `here `__ to see an example of how to use list_external_database_connectors API. """ - resource_path = "/dbNodes" + resource_path = "/externaldatabaseconnectors" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "db_system_id", - "vm_cluster_id", + "opc_request_id", "limit", "page", "sort_by", "sort_order", - "lifecycle_state" + "lifecycle_state", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_nodes got unknown kwargs: {!r}".format(extra_kwargs)) + "list_external_database_connectors got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED"] + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -11402,7 +14255,7 @@ def list_db_nodes(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -11410,20 +14263,22 @@ def list_db_nodes(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "dbSystemId": kwargs.get("db_system_id", missing), - "vmClusterId": kwargs.get("vm_cluster_id", missing), + "externalDatabaseId": external_database_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing) + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11436,31 +14291,55 @@ def list_db_nodes(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbNodeSummary]") + response_type="list[ExternalDatabaseConnectorSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DbNodeSummary]") + response_type="list[ExternalDatabaseConnectorSummary]") - def list_db_system_patch_history_entries(self, db_system_id, **kwargs): + def list_external_non_container_databases(self, compartment_id, **kwargs): """ - Gets the history of the patch actions performed on the specified DB system. + Gets a list of the ExternalNonContainerDatabases in the specified compartment. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). + Default order for TIMECREATED is descending. + Default order for DISPLAYNAME is ascending. + The DISPLAYNAME sort order is case sensitive. + + Allowed values are: "DISPLAYNAME", "TIMECREATED" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the specified lifecycle state. + + Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11469,46 +14348,69 @@ def list_db_system_patch_history_entries(self, db_system_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalNonContainerDatabaseSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_system_patch_history_entries API. + Click `here `__ to see an example of how to use list_external_non_container_databases API. """ - resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries" + resource_path = "/externalnoncontainerdatabases" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "opc_request_id", "limit", - "page" + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_system_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) + "list_external_non_container_databases got unknown kwargs: {!r}".format(extra_kwargs)) - path_params = { - "dbSystemId": db_system_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) query_params = { + "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11519,26 +14421,33 @@ def list_db_system_patch_history_entries(self, db_system_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + response_type="list[ExternalNonContainerDatabaseSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + response_type="list[ExternalNonContainerDatabaseSummary]") - def list_db_system_patches(self, db_system_id, **kwargs): + def list_external_pluggable_databases(self, compartment_id, **kwargs): """ - Lists the patches applicable to the specified DB system. + Gets a list of the :func:`create_external_pluggable_database_details` + resources in the specified compartment. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str external_container_database_id: (optional) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -11548,6 +14457,27 @@ def list_db_system_patches(self, db_system_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). + Default order for TIMECREATED is descending. + Default order for DISPLAYNAME is ascending. + The DISPLAYNAME sort order is case sensitive. + + Allowed values are: "DISPLAYNAME", "TIMECREATED" + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the specified lifecycle state. + + Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11556,46 +14486,71 @@ def list_db_system_patches(self, db_system_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalPluggableDatabaseSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_system_patches API. + Click `here `__ to see an example of how to use list_external_pluggable_databases API. """ - resource_path = "/dbSystems/{dbSystemId}/patches" + resource_path = "/externalpluggabledatabases" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "opc_request_id", + "external_container_database_id", "limit", - "page" + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_system_patches got unknown kwargs: {!r}".format(extra_kwargs)) + "list_external_pluggable_databases got unknown kwargs: {!r}".format(extra_kwargs)) - path_params = { - "dbSystemId": db_system_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) + ) query_params = { + "compartmentId": compartment_id, + "externalContainerDatabaseId": kwargs.get("external_container_database_id", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11606,22 +14561,20 @@ def list_db_system_patches(self, db_system_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="list[ExternalPluggableDatabaseSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="list[ExternalPluggableDatabaseSummary]") - def list_db_system_shapes(self, compartment_id, **kwargs): + def list_flex_components(self, compartment_id, **kwargs): """ - Gets a list of the shapes that can be used to launch a new 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. + Gets a list of the flex components that can be used to launch a new DB system. The flex component determines resources to allocate to the DB system - Database Servers and Storage Servers. :param str compartment_id: (required) @@ -11629,8 +14582,18 @@ def list_db_system_shapes(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str availability_domain: (optional) - The name of the Availability Domain. + :param str name: (optional) + A filter to return only resources that match the entire name given. The match is not case sensitive. + + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for NAME is ascending. The NAME sort order is case sensitive. + + Allowed values are: "NAME" :param int limit: (optional) The maximum number of items to return per page. @@ -11646,30 +14609,48 @@ def list_db_system_shapes(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemShapeSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.FlexComponentCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_system_shapes API. + Click `here `__ to see an example of how to use list_flex_components API. """ - resource_path = "/dbSystemShapes" + resource_path = "/dbSystemShapes/flexComponents" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "availability_domain", + "name", + "sort_order", + "sort_by", "limit", "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_system_shapes got unknown kwargs: {!r}".format(extra_kwargs)) + "list_flex_components got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["NAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) query_params = { - "availabilityDomain": kwargs.get("availability_domain", missing), "compartmentId": compartment_id, + "name": kwargs.get("name", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -11691,25 +14672,18 @@ def list_db_system_shapes(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemShapeSummary]") + response_type="FlexComponentCollection") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemShapeSummary]") + response_type="FlexComponentCollection") - def list_db_systems(self, compartment_id, **kwargs): + def list_gi_versions(self, compartment_id, **kwargs): """ - Lists the DB systems in the specified compartment. You can specify a `backupId` to list only the DB systems that support creating a database using this backup in this compartment. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Gets a list of supported GI versions for the Exadata Cloud@Customer VM cluster. :param str compartment_id: (required) @@ -11723,33 +14697,13 @@ def list_db_systems(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str backup_id: (optional) - The `OCID`__ of the backup. Specify a backupId to list only the DB systems or DB homes that support creating a database using this backup in this compartment. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). Allowed values are: "ASC", "DESC" - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MIGRATED", "MAINTENANCE_IN_PROGRESS", "NEEDS_ATTENTION" - - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. - - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param str shape: (optional) + If provided, filters the results for the given shape. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11759,13 +14713,13 @@ def list_db_systems(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.GiVersionSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_systems API. + Click `here `__ to see an example of how to use list_gi_versions API. """ - resource_path = "/dbSystems" + resource_path = "/giVersions" method = "GET" # Don't accept unknown kwargs @@ -11773,24 +14727,13 @@ def list_db_systems(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", - "backup_id", - "sort_by", "sort_order", - "lifecycle_state", - "availability_domain", - "display_name" + "shape" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_systems got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) + "list_gi_versions got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -11799,23 +14742,12 @@ def list_db_systems(self, compartment_id, **kwargs): "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) ) - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MIGRATED", "MAINTENANCE_IN_PROGRESS", "NEEDS_ATTENTION"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) - query_params = { "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "backupId": kwargs.get("backup_id", missing), - "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "availabilityDomain": kwargs.get("availability_domain", missing), - "displayName": kwargs.get("display_name", missing) + "shape": kwargs.get("shape", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -11835,18 +14767,18 @@ def list_db_systems(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemSummary]") + response_type="list[GiVersionSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemSummary]") + response_type="list[GiVersionSummary]") - def list_db_versions(self, compartment_id, **kwargs): + def list_key_stores(self, compartment_id, **kwargs): """ - Gets a list of supported Oracle Database versions. + Gets a list of key stores in the specified compartment. :param str compartment_id: (required) @@ -11860,23 +14792,8 @@ def list_db_versions(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str db_system_shape: (optional) - If provided, filters the results to the set of database versions which are supported for the given shape. - - :param str db_system_id: (optional) - The DB system `OCID`__. If provided, filters the results to the set of database versions which are supported for the DB system. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str storage_management: (optional) - The DB system storage management option. Used to list database versions available for that storage manager. Valid values are: - * ASM - Automatic storage management - * LVM - Logical volume management - - Allowed values are: "ASM", "LVM" - - :param bool is_upgrade_supported: (optional) - If provided, filters the results to the set of database versions which are supported for Upgrade. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11886,13 +14803,13 @@ def list_db_versions(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.KeyStoreSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_versions API. + Click `here `__ to see an example of how to use list_key_stores API. """ - resource_path = "/dbVersions" + resource_path = "/keyStores" method = "GET" # Don't accept unknown kwargs @@ -11900,38 +14817,26 @@ def list_db_versions(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", - "db_system_shape", - "db_system_id", - "storage_management", - "is_upgrade_supported" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_db_versions got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'storage_management' in kwargs: - storage_management_allowed_values = ["ASM", "LVM"] - if kwargs['storage_management'] not in storage_management_allowed_values: - raise ValueError( - "Invalid value for `storage_management`, must be one of {0}".format(storage_management_allowed_values) - ) + "list_key_stores got unknown kwargs: {!r}".format(extra_kwargs)) query_params = { "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "dbSystemShape": kwargs.get("db_system_shape", missing), - "dbSystemId": kwargs.get("db_system_id", missing), - "storageManagement": kwargs.get("storage_management", missing), - "isUpgradeSupported": kwargs.get("is_upgrade_supported", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -11944,19 +14849,18 @@ def list_db_versions(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbVersionSummary]") + response_type="list[KeyStoreSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[DbVersionSummary]") + response_type="list[KeyStoreSummary]") - def list_exadata_infrastructures(self, compartment_id, **kwargs): + def list_maintenance_runs(self, compartment_id, **kwargs): """ - Lists the Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud@Customer instances only. - To list the Exadata Cloud Service infrastructure resources in a compartment, use the :func:`list_cloud_exadata_infrastructures` operation. + Gets a list of the maintenance runs in the specified compartment. :param str compartment_id: (required) @@ -11964,19 +14868,31 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str target_resource_id: (optional) + The target resource ID. + + :param str target_resource_type: (optional) + The type of the target resource. + + Allowed values are: "AUTONOMOUS_EXADATA_INFRASTRUCTURE", "AUTONOMOUS_CONTAINER_DATABASE", "EXADATA_DB_SYSTEM", "CLOUD_EXADATA_INFRASTRUCTURE", "EXACC_INFRASTRUCTURE" + + :param str maintenance_type: (optional) + The maintenance type. + + Allowed values are: "PLANNED", "UNPLANNED" + :param int limit: (optional) The maximum number of items to return per page. :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIME_SCHEDULED and TIME_ENDED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + + Allowed values are: "TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -11986,10 +14902,10 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS" + Allowed values are: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED" - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param str availability_domain: (optional) + A filter to return only resources that match the given availability domain exactly. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -11999,33 +14915,49 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExadataInfrastructureSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.MaintenanceRunSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_exadata_infrastructures API. + Click `here `__ to see an example of how to use list_maintenance_runs API. """ - resource_path = "/exadataInfrastructures" + resource_path = "/maintenanceRuns" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "target_resource_id", + "target_resource_type", + "maintenance_type", "limit", "page", - "opc_request_id", "sort_by", "sort_order", "lifecycle_state", - "display_name" + "availability_domain" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_exadata_infrastructures got unknown kwargs: {!r}".format(extra_kwargs)) + "list_maintenance_runs got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'target_resource_type' in kwargs: + target_resource_type_allowed_values = ["AUTONOMOUS_EXADATA_INFRASTRUCTURE", "AUTONOMOUS_CONTAINER_DATABASE", "EXADATA_DB_SYSTEM", "CLOUD_EXADATA_INFRASTRUCTURE", "EXACC_INFRASTRUCTURE"] + if kwargs['target_resource_type'] not in target_resource_type_allowed_values: + raise ValueError( + "Invalid value for `target_resource_type`, must be one of {0}".format(target_resource_type_allowed_values) + ) + + if 'maintenance_type' in kwargs: + maintenance_type_allowed_values = ["PLANNED", "UNPLANNED"] + if kwargs['maintenance_type'] not in maintenance_type_allowed_values: + raise ValueError( + "Invalid value for `maintenance_type`, must be one of {0}".format(maintenance_type_allowed_values) + ) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + sort_by_allowed_values = ["TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -12039,7 +14971,7 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -12047,21 +14979,22 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, + "targetResourceId": kwargs.get("target_resource_id", missing), + "targetResourceType": kwargs.get("target_resource_type", missing), + "maintenanceType": kwargs.get("maintenance_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) + "availabilityDomain": kwargs.get("availability_domain", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12074,43 +15007,56 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExadataInfrastructureSummary]") + response_type="list[MaintenanceRunSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, query_params=query_params, header_params=header_params, - response_type="list[ExadataInfrastructureSummary]") + response_type="list[MaintenanceRunSummary]") - def list_flex_components(self, compartment_id, **kwargs): + def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, **kwargs): """ - Gets a list of the flex components that can be used to launch a new DB system. The flex component determines resources to allocate to the DB system - Database Servers and Storage Servers. + Gets a list of the VM cluster networks in the specified compartment. Applies to Exadata Cloud@Customer instances only. + + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str compartment_id: (required) The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str name: (optional) - A filter to return only resources that match the entire name given. The match is not case sensitive. + :param int limit: (optional) + The maximum number of items to return per page. + + :param str page: (optional) + The pagination token to continue listing from. + + :param str sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). Allowed values are: "ASC", "DESC" - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for NAME is ascending. The NAME sort order is case sensitive. + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "NAME" + Allowed values are: "CREATING", "REQUIRES_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED" - :param int limit: (optional) - The maximum number of items to return per page. + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. - :param str page: (optional) - The pagination token to continue listing from. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12120,28 +15066,47 @@ def list_flex_components(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.FlexComponentCollection` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterNetworkSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_flex_components API. + Click `here `__ to see an example of how to use list_vm_cluster_networks API. """ - resource_path = "/dbSystemShapes/flexComponents" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "name", - "sort_order", - "sort_by", "limit", - "page" + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_flex_components got unknown kwargs: {!r}".format(extra_kwargs)) + "list_vm_cluster_networks got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "exadataInfrastructureId": exadata_infrastructure_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -12150,27 +15115,30 @@ def list_flex_components(self, compartment_id, **kwargs): "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) ) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["NAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "REQUIRES_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) ) query_params = { "compartmentId": compartment_id, - "name": kwargs.get("name", missing), - "sortOrder": kwargs.get("sort_order", missing), - "sortBy": kwargs.get("sort_by", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12181,24 +15149,26 @@ def list_flex_components(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="FlexComponentCollection") + response_type="list[VmClusterNetworkSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="FlexComponentCollection") + response_type="list[VmClusterNetworkSummary]") - def list_gi_versions(self, compartment_id, **kwargs): + def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): """ - Gets a list of supported GI versions for the Exadata Cloud@Customer VM cluster. + Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -12208,14 +15178,6 @@ def list_gi_versions(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str shape: (optional) - If provided, filters the results for the given shape. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12224,41 +15186,39 @@ def list_gi_versions(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.GiVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_gi_versions API. + Click `here `__ to see an example of how to use list_vm_cluster_patch_history_entries API. """ - resource_path = "/giVersions" + resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page", - "sort_order", - "shape" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_gi_versions got unknown kwargs: {!r}".format(extra_kwargs)) + "list_vm_cluster_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + path_params = { + "vmClusterId": vm_cluster_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), - "shape": kwargs.get("shape", missing) + "page": kwargs.get("page", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -12276,24 +15236,26 @@ def list_gi_versions(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[GiVersionSummary]") + response_type="list[PatchHistoryEntrySummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[GiVersionSummary]") + response_type="list[PatchHistoryEntrySummary]") - def list_key_stores(self, compartment_id, **kwargs): + def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): """ - Gets a list of key stores in the specified compartment. + Lists the patches applicable to the specified VM cluster in an Exadata Cloud@Customer system. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -12303,9 +15265,6 @@ def list_key_stores(self, compartment_id, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12314,29 +15273,37 @@ def list_key_stores(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.KeyStoreSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_key_stores API. + Click `here `__ to see an example of how to use list_vm_cluster_patches API. """ - resource_path = "/keyStores" + resource_path = "/vmClusters/{vmClusterId}/patches" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "limit", - "page", - "opc_request_id" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_key_stores got unknown kwargs: {!r}".format(extra_kwargs)) + "list_vm_cluster_patches got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "vmClusterId": vm_cluster_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -12344,10 +15311,8 @@ def list_key_stores(self, compartment_id, **kwargs): header_params = { "accept": "application/json", - "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "content-type": "application/json" } - header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12358,20 +15323,23 @@ def list_key_stores(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[KeyStoreSummary]") + response_type="list[PatchSummary]") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[KeyStoreSummary]") + response_type="list[PatchSummary]") - def list_maintenance_runs(self, compartment_id, **kwargs): + def list_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of the maintenance runs in the specified compartment. + Lists the VM clusters in the specified compartment. Applies to Exadata Cloud@Customer instances only. + To list the cloud VM clusters in an Exadata Cloud Service instance, use the :func:`list_cloud_vm_clusters` operation. :param str compartment_id: (required) @@ -12379,18 +15347,8 @@ def list_maintenance_runs(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str target_resource_id: (optional) - The target resource ID. - - :param str target_resource_type: (optional) - The type of the target resource. - - Allowed values are: "AUTONOMOUS_EXADATA_INFRASTRUCTURE", "AUTONOMOUS_CONTAINER_DATABASE", "EXADATA_DB_SYSTEM", "CLOUD_EXADATA_INFRASTRUCTURE", "EXACC_INFRASTRUCTURE" - - :param str maintenance_type: (optional) - The maintenance type. - - Allowed values are: "PLANNED", "UNPLANNED" + :param str exadata_infrastructure_id: (optional) + If provided, filters the results for the given Exadata Infrastructure. :param int limit: (optional) The maximum number of items to return per page. @@ -12399,11 +15357,9 @@ def list_maintenance_runs(self, compartment_id, **kwargs): The pagination token to continue listing from. :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIME_SCHEDULED and TIME_ENDED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - **Note:** If you do not include the availability domain filter, the resources are grouped by availability domain, then sorted. + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - Allowed values are: "TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME" + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -12413,10 +15369,13 @@ def list_maintenance_runs(self, compartment_id, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. + :param str display_name: (optional) + A filter to return only resources that match the entire display name given. The match is not case sensitive. + + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12426,49 +15385,34 @@ def list_maintenance_runs(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.MaintenanceRunSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_maintenance_runs API. + Click `here `__ to see an example of how to use list_vm_clusters API. """ - resource_path = "/maintenanceRuns" + resource_path = "/vmClusters" method = "GET" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "target_resource_id", - "target_resource_type", - "maintenance_type", + "exadata_infrastructure_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "availability_domain" + "display_name", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_maintenance_runs got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'target_resource_type' in kwargs: - target_resource_type_allowed_values = ["AUTONOMOUS_EXADATA_INFRASTRUCTURE", "AUTONOMOUS_CONTAINER_DATABASE", "EXADATA_DB_SYSTEM", "CLOUD_EXADATA_INFRASTRUCTURE", "EXACC_INFRASTRUCTURE"] - if kwargs['target_resource_type'] not in target_resource_type_allowed_values: - raise ValueError( - "Invalid value for `target_resource_type`, must be one of {0}".format(target_resource_type_allowed_values) - ) - - if 'maintenance_type' in kwargs: - maintenance_type_allowed_values = ["PLANNED", "UNPLANNED"] - if kwargs['maintenance_type'] not in maintenance_type_allowed_values: - raise ValueError( - "Invalid value for `maintenance_type`, must be one of {0}".format(maintenance_type_allowed_values) - ) + "list_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) @@ -12482,7 +15426,7 @@ def list_maintenance_runs(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) @@ -12490,22 +15434,22 @@ def list_maintenance_runs(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "targetResourceId": kwargs.get("target_resource_id", missing), - "targetResourceType": kwargs.get("target_resource_type", missing), - "maintenanceType": kwargs.get("maintenance_type", missing), + "exadataInfrastructureId": kwargs.get("exadata_infrastructure_id", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "availabilityDomain": kwargs.get("availability_domain", missing) + "displayName": kwargs.get("display_name", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12518,53 +15462,139 @@ def list_maintenance_runs(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[MaintenanceRunSummary]") + response_type="list[VmClusterSummary]") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[VmClusterSummary]") + + def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): + """ + Migrates the Exadata DB system to the new `Exadata resource model`__. + All related resources will be migrated. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + + + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str if_match: (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. + + :param str opc_retry_token: (optional) + 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). + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataDbSystemMigration` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use migrate_exadata_db_system_resource_model API. + """ + resource_path = "/dbSystems/{dbSystemId}/actions/migration" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "if_match", + "opc_retry_token" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "migrate_exadata_db_system_resource_model got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "dbSystemId": db_system_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ExadataDbSystemMigration") else: return self.base_client.call_api( resource_path=resource_path, method=method, - query_params=query_params, + path_params=path_params, header_params=header_params, - response_type="list[MaintenanceRunSummary]") + response_type="ExadataDbSystemMigration") - def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, **kwargs): + def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): """ - Gets a list of the VM cluster networks in the specified compartment. Applies to Exadata Cloud@Customer instances only. - + Changes encryption key management from customer-managed, using the `Vault service`__, to Oracle-managed. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (required) - The compartment `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param int limit: (optional) - The maximum number of items to return per page. - - :param str page: (optional) - The pagination token to continue listing from. - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. + :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) + Request to change the source of the encryption key for the database. - Allowed values are: "CREATING", "REQUIRES_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED" + :param str if_match: (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. - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param str opc_retry_token: (optional) + 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). :param str opc_request_id: (optional) Unique identifier for the request. @@ -12577,33 +15607,29 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterNetworkSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_cluster_networks API. + Click `here `__ to see an example of how to use migrate_vault_key API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" - method = "GET" + resource_path = "/databases/{databaseId}/actions/migrateKey" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", + "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_vm_cluster_networks got unknown kwargs: {!r}".format(extra_kwargs)) + "migrate_vault_key got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12612,41 +15638,11 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "REQUIRES_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) - - query_params = { - "compartmentId": compartment_id, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -12656,38 +15652,40 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[VmClusterNetworkSummary]") + body=migrate_vault_key_details, + response_type="Database") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[VmClusterNetworkSummary]") + body=migrate_vault_key_details, + response_type="Database") - def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): + def register_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): """ - Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system. + Asynchronously registers this Autonomous Database with Data Safe. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param int limit: (optional) - The maximum number of items to return per page. + :param str opc_request_id: (optional) + Unique identifier for the request. - :param str page: (optional) - The pagination token to continue listing from. + :param oci.database.models.RegisterAutonomousDatabaseDataSafeDetails register_autonomous_database_data_safe_details: (optional) + Request to register an Autonomous Database with Data Safe. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12697,28 +15695,28 @@ def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_cluster_patch_history_entries API. + Click `here `__ to see an example of how to use register_autonomous_database_data_safe API. """ - resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries" - method = "GET" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/registerDataSafe" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "limit", - "page" + "opc_request_id", + "register_autonomous_database_data_safe_details" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_vm_cluster_patch_history_entries got unknown kwargs: {!r}".format(extra_kwargs)) + "register_autonomous_database_data_safe got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12727,16 +15725,12 @@ def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - query_params = { - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12748,33 +15742,35 @@ def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + body=kwargs.get('register_autonomous_database_data_safe_details')) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]") + body=kwargs.get('register_autonomous_database_data_safe_details')) - def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): + def reinstate_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Lists the patches applicable to the specified VM cluster in an Exadata Cloud@Customer system. + Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby Autonomous Container Database. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param int limit: (optional) - The maximum number of items to return per page. + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - :param str page: (optional) - The pagination token to continue listing from. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12784,28 +15780,28 @@ def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PatchSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_cluster_patches API. + Click `here `__ to see an example of how to use reinstate_autonomous_container_database_dataguard_association API. """ - resource_path = "/vmClusters/{vmClusterId}/patches" - method = "GET" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/reinstate" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "limit", - "page" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_vm_cluster_patches got unknown kwargs: {!r}".format(extra_kwargs)) + "reinstate_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "vmClusterId": vm_cluster_id + "autonomousContainerDatabaseId": autonomous_container_database_id, + "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12814,16 +15810,12 @@ def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) - query_params = { - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} - header_params = { "accept": "application/json", - "content-type": "application/json" + "content-type": "application/json", + "if-match": kwargs.get("if_match", missing) } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} retry_strategy = self.retry_strategy if kwargs.get('retry_strategy'): @@ -12835,58 +15827,38 @@ def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="AutonomousContainerDatabaseDataguardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[PatchSummary]") + response_type="AutonomousContainerDatabaseDataguardAssociation") - def list_vm_clusters(self, compartment_id, **kwargs): + def reinstate_data_guard_association(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, **kwargs): """ - Lists the VM clusters in the specified compartment. Applies to Exadata Cloud@Customer instances only. - To list the cloud VM clusters in an Exadata Cloud Service instance, use the :func:`list_cloud_vm_clusters` operation. + Reinstates the database identified by the `databaseId` parameter into the standby role in a Data Guard association. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str exadata_infrastructure_id: (optional) - If provided, filters the results for the given Exadata Infrastructure. - - :param int limit: (optional) - The maximum number of items to return per page. - - :param str page: (optional) - The pagination token to continue listing from. - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). - - Allowed values are: "ASC", "DESC" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) + A request to reinstate a database in a standby role. - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -12896,69 +15868,40 @@ def list_vm_clusters(self, compartment_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_clusters API. + Click `here `__ to see an example of how to use reinstate_data_guard_association API. """ - resource_path = "/vmClusters" - method = "GET" + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/reinstate" + method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "exadata_infrastructure_id", - "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "list_vm_clusters got unknown kwargs: {!r}".format(extra_kwargs)) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) - ) + "reinstate_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) - ) + path_params = { + "databaseId": database_id, + "dataGuardAssociationId": data_guard_association_id + } - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - "Invalid value for `lifecycle_state`, must be one of {0}".format(lifecycle_state_allowed_values) - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - query_params = { - "compartmentId": compartment_id, - "exadataInfrastructureId": kwargs.get("exadata_infrastructure_id", missing), - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), - "sortOrder": kwargs.get("sort_order", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) - } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -12971,44 +15914,36 @@ def list_vm_clusters(self, compartment_id, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, - query_params=query_params, + path_params=path_params, header_params=header_params, - response_type="list[VmClusterSummary]") + body=reinstate_data_guard_association_details, + response_type="DataGuardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, - query_params=query_params, + path_params=path_params, header_params=header_params, - response_type="list[VmClusterSummary]") + body=reinstate_data_guard_association_details, + response_type="DataGuardAssociation") - def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): + def restart_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Migrates the Exadata DB system to the new `Exadata resource model`__. - All related resources will be migrated. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + Rolling restarts the specified Autonomous Container Database. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. - :param str if_match: (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. - :param str opc_retry_token: (optional) - 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). + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13018,29 +15953,28 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataDbSystemMigration` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use migrate_exadata_db_system_resource_model API. + Click `here `__ to see an example of how to use restart_autonomous_container_database API. """ - resource_path = "/dbSystems/{dbSystemId}/actions/migration" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/restart" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", "if_match", - "opc_retry_token" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "migrate_exadata_db_system_resource_model got unknown kwargs: {!r}".format(extra_kwargs)) + "restart_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13052,9 +15986,8 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing) + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13063,53 +15996,36 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExadataDbSystemMigration") + response_type="AutonomousContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="ExadataDbSystemMigration") + response_type="AutonomousContainerDatabase") - def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): + def restart_autonomous_database(self, autonomous_database_id, **kwargs): """ - Changes encryption key management from customer-managed, using the `Vault service`__, to Oracle-managed. - - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + Restarts the specified Autonomous Database. - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) - Request to change the source of the encryption key for the database. - :param str if_match: (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. - :param str opc_retry_token: (optional) - 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). - - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13118,29 +16034,27 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use migrate_vault_key API. + Click `here `__ to see an example of how to use restart_autonomous_database API. """ - resource_path = "/databases/{databaseId}/actions/migrateKey" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restart" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "migrate_vault_key got unknown kwargs: {!r}".format(extra_kwargs)) + "restart_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13152,9 +16066,7 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13163,28 +16075,24 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=migrate_vault_key_details, - response_type="Database") + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=migrate_vault_key_details, - response_type="Database") + response_type="AutonomousDatabase") - def register_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): + def restore_autonomous_database(self, autonomous_database_id, restore_autonomous_database_details, **kwargs): """ - Asynchronously registers this Autonomous Database with Data Safe. + Restores an Autonomous Database based on the provided request parameters. :param str autonomous_database_id: (required) @@ -13192,11 +16100,13 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) + Request to perform an Autonomous Database restore. - :param oci.database.models.RegisterAutonomousDatabaseDataSafeDetails register_autonomous_database_data_safe_details: (optional) - Request to register an Autonomous Database with Data Safe. + :param str if_match: (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. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13206,25 +16116,24 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use register_autonomous_database_data_safe API. + Click `here `__ to see an example of how to use restore_autonomous_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/registerDataSafe" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restore" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "register_autonomous_database_data_safe_details" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "register_autonomous_database_data_safe got unknown kwargs: {!r}".format(extra_kwargs)) + "restore_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { "autonomousDatabaseId": autonomous_database_id @@ -13239,7 +16148,7 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13254,29 +16163,29 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('register_autonomous_database_data_safe_details')) + body=restore_autonomous_database_details, + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('register_autonomous_database_data_safe_details')) + body=restore_autonomous_database_details, + response_type="AutonomousDatabase") - def reinstate_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def restore_database(self, database_id, restore_database_details, **kwargs): """ - Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby Autonomous Container Database. + Restore a Database based on the request parameters you provide. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) + Request to perform database restore. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -13291,13 +16200,13 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use reinstate_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use restore_database API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/reinstate" + resource_path = "/databases/{databaseId}/actions/restore" method = "POST" # Don't accept unknown kwargs @@ -13308,11 +16217,10 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "reinstate_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "restore_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13339,38 +16247,44 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + body=restore_database_details, + response_type="Database") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + body=restore_database_details, + response_type="Database") - def reinstate_data_guard_association(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, **kwargs): + def rotate_autonomous_container_database_encryption_key(self, autonomous_container_database_id, **kwargs): """ - Reinstates the database identified by the `databaseId` parameter into the standby role in a Data Guard association. - + Creates a new version of an existing `Vault service`__ key. - :param str database_id: (required) - The database `OCID`__. + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) - A request to reinstate a database in a standby role. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). + + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13379,28 +16293,29 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use reinstate_data_guard_association API. + Click `here `__ to see an example of how to use rotate_autonomous_container_database_encryption_key API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/reinstate" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/rotateKey" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "reinstate_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "rotate_autonomous_container_database_encryption_key got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13412,7 +16327,9 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13421,30 +16338,32 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=reinstate_data_guard_association_details, - response_type="DataGuardAssociation") + response_type="AutonomousContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=reinstate_data_guard_association_details, - response_type="DataGuardAssociation") + response_type="AutonomousContainerDatabase") - def restart_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kwargs): """ - Rolling restarts the specified Autonomous Container Database. + Rotate existing AutonomousDatabase `Vault service`__ key. + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -13453,6 +16372,13 @@ def restart_autonomous_container_database(self, autonomous_container_database_id 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. + :param str opc_retry_token: (optional) + 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). + :param str opc_request_id: (optional) Unique identifier for the request. @@ -13464,28 +16390,29 @@ def restart_autonomous_container_database(self, autonomous_container_database_id To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use restart_autonomous_container_database API. + Click `here `__ to see an example of how to use rotate_autonomous_database_encryption_key API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/restart" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/rotateKey" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", "if_match", + "opc_retry_token", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "restart_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + "rotate_autonomous_database_encryption_key got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13498,6 +16425,7 @@ def restart_autonomous_container_database(self, autonomous_container_database_id "accept": "application/json", "content-type": "application/json", "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13507,31 +16435,43 @@ def restart_autonomous_container_database(self, autonomous_container_database_id retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase") + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase") + response_type="AutonomousDatabase") - def restart_autonomous_database(self, autonomous_database_id, **kwargs): + def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Restarts the specified Autonomous Database. + Rotates Oracle REST Data Services (ORDS) certs for an Autonomous Exadata Infrastructure resource. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str opc_retry_token: (optional) + 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). + :param str if_match: (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 @@ -13545,27 +16485,29 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use restart_autonomous_database API. + Click `here `__ to see an example of how to use rotate_ords_certs API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restart" + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateOrdsCerts" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "opc_request_id", + "opc_retry_token", "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "restart_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "rotate_ords_certs got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13577,6 +16519,8 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13586,33 +16530,40 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) - def restore_autonomous_database(self, autonomous_database_id, restore_autonomous_database_details, **kwargs): + def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Restores an Autonomous Database based on the provided request parameters. + Rotates SSL certs for an Autonomous Exadata Infrastructure resource. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) - Request to perform an Autonomous Database restore. + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param str opc_retry_token: (optional) + 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). :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -13627,27 +16578,29 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use restore_autonomous_database API. + Click `here `__ to see an example of how to use rotate_ssl_certs API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restore" + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateSslCerts" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "opc_request_id", + "opc_retry_token", "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "restore_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "rotate_ssl_certs got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13659,6 +16612,8 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous header_params = { "accept": "application/json", "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13668,26 +16623,26 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=restore_autonomous_database_details, - response_type="AutonomousDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - body=restore_autonomous_database_details, - response_type="AutonomousDatabase") + header_params=header_params) - def restore_database(self, database_id, restore_database_details, **kwargs): + def rotate_vault_key(self, database_id, **kwargs): """ - Restore a Database based on the request parameters you provide. + Creates a new version of an existing `Vault service`__ key. + + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm :param str database_id: (required) @@ -13695,14 +16650,21 @@ def restore_database(self, database_id, restore_database_details, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) - Request to perform database restore. - :param str if_match: (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. + :param str opc_retry_token: (optional) + 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). + + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13715,20 +16677,22 @@ def restore_database(self, database_id, restore_database_details, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use restore_database API. + Click `here `__ to see an example of how to use rotate_vault_key API. """ - resource_path = "/databases/{databaseId}/actions/restore" + resource_path = "/databases/{databaseId}/actions/rotateKey" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_retry_token", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "restore_database got unknown kwargs: {!r}".format(extra_kwargs)) + "rotate_vault_key got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { "databaseId": database_id @@ -13743,7 +16707,9 @@ def restore_database(self, database_id, restore_database_details, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13752,13 +16718,14 @@ def restore_database(self, database_id, restore_database_details, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=restore_database_details, response_type="Database") else: return self.base_client.call_api( @@ -13766,25 +16733,27 @@ def restore_database(self, database_id, restore_database_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=restore_database_details, response_type="Database") - def rotate_autonomous_container_database_encryption_key(self, autonomous_container_database_id, **kwargs): + def scan_external_container_database_pluggable_databases(self, external_container_database_id, external_database_connector_id, **kwargs): """ - Creates a new version of an existing `Vault service`__ key. + Scans for pluggable databases in the specified external container database. + This operation will return un-registered pluggable databases in the `GetWorkRequest` operation. - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -13793,9 +16762,6 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain has been deleted and purged from the system, then a retry of the original creation request may be rejected). - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13804,29 +16770,28 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_autonomous_container_database_encryption_key API. + Click `here `__ to see an example of how to use scan_external_container_database_pluggable_databases API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/rotateKey" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/scanPluggableDatabases" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id" + "opc_request_id", + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "rotate_autonomous_container_database_encryption_key got unknown kwargs: {!r}".format(extra_kwargs)) + "scan_external_container_database_pluggable_databases got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -13835,12 +16800,16 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + query_params = { + "externalDatabaseConnectorId": external_database_connector_id + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13856,21 +16825,19 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabase") + query_params=query_params, + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabase") + query_params=query_params, + header_params=header_params) - def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kwargs): + def start_autonomous_database(self, autonomous_database_id, **kwargs): """ - Rotate existing AutonomousDatabase `Vault service`__ key. - - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + Starts the specified Autonomous Database. :param str autonomous_database_id: (required) @@ -13883,16 +16850,6 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw 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. - :param str opc_retry_token: (optional) - 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). - - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13905,22 +16862,20 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_autonomous_database_encryption_key API. + Click `here `__ to see an example of how to use start_autonomous_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/rotateKey" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/start" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "rotate_autonomous_database_encryption_key got unknown kwargs: {!r}".format(extra_kwargs)) + "start_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { "autonomousDatabaseId": autonomous_database_id @@ -13935,9 +16890,7 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -13946,8 +16899,6 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, @@ -13963,31 +16914,24 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw header_params=header_params, response_type="AutonomousDatabase") - def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): + def stop_autonomous_database(self, autonomous_database_id, **kwargs): """ - Rotates Oracle REST Data Services (ORDS) certs for an Autonomous Exadata Infrastructure resource. + Stops the specified Autonomous Database. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. - - :param str opc_retry_token: (optional) - 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). - :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -13996,29 +16940,28 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_ords_certs API. + Click `here `__ to see an example of how to use stop_autonomous_database API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateOrdsCerts" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/stop" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "opc_retry_token", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "rotate_ords_certs got unknown kwargs: {!r}".format(extra_kwargs)) + "stop_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14030,9 +16973,8 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14041,40 +16983,37 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + response_type="AutonomousDatabase") - def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): + def switchover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Rotates SSL certs for an Autonomous Exadata Infrastructure resource. + Switches over the primary Autonomous Container Database of an Autonomous Data Guard peer association to standby role. The standby Autonomous Container Database associated with autonomousContainerDatabaseDataguardAssociationId assumes the primary Autonomous Container Database role. + A switchover incurs no data loss. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - :param str opc_retry_token: (optional) - 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). + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -14089,29 +17028,28 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_ssl_certs API. + Click `here `__ to see an example of how to use switchover_autonomous_container_database_dataguard_association API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateSslCerts" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/switchover" method = "POST" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "opc_retry_token", "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "rotate_ssl_certs got unknown kwargs: {!r}".format(extra_kwargs)) + "switchover_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "autonomousContainerDatabaseId": autonomous_container_database_id, + "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14123,8 +17061,6 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14134,29 +17070,27 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + response_type="AutonomousContainerDatabaseDataguardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + response_type="AutonomousContainerDatabaseDataguardAssociation") - def rotate_vault_key(self, database_id, **kwargs): + def switchover_autonomous_database(self, autonomous_database_id, **kwargs): """ - Creates a new version of an existing `Vault service`__ key. - - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + Initiates a switchover of the specified Autonomous Database to the associated standby database. Applicable only to databases with Autonomous Data Guard enabled. - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -14184,13 +17118,13 @@ def rotate_vault_key(self, database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_vault_key API. + Click `here `__ to see an example of how to use switchover_autonomous_database API. """ - resource_path = "/databases/{databaseId}/actions/rotateKey" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/switchover" method = "POST" # Don't accept unknown kwargs @@ -14203,10 +17137,10 @@ def rotate_vault_key(self, database_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "rotate_vault_key got unknown kwargs: {!r}".format(extra_kwargs)) + "switchover_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14237,25 +17171,36 @@ def rotate_vault_key(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database") + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="Database") + response_type="AutonomousDatabase") - def start_autonomous_database(self, autonomous_database_id, **kwargs): + def switchover_data_guard_association(self, database_id, data_guard_association_id, switchover_data_guard_association_details, **kwargs): """ - Starts the specified Autonomous Database. + Performs a switchover to transition the primary database of a Data Guard association into a standby role. The + standby database associated with the `dataGuardAssociationId` assumes the primary database role. + A switchover guarantees no data loss. - :param str autonomous_database_id: (required) + + :param str database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) + Request to swtichover a primary to a standby. + :param str if_match: (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 @@ -14269,13 +17214,13 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use start_autonomous_database API. + Click `here `__ to see an example of how to use switchover_data_guard_association API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/start" + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/switchover" method = "POST" # Don't accept unknown kwargs @@ -14286,10 +17231,11 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "start_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "switchover_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "databaseId": database_id, + "dataGuardAssociationId": data_guard_association_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14316,22 +17262,24 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase") + body=switchover_data_guard_association_details, + response_type="DataGuardAssociation") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase") + body=switchover_data_guard_association_details, + response_type="DataGuardAssociation") - def stop_autonomous_database(self, autonomous_database_id, **kwargs): + def terminate_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Stops the specified Autonomous Database. + Terminates an Autonomous Container Database, which permanently deletes the container database and any databases within the container database. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the container database is terminated. Oracle recommends that you back up any data in the Autonomous Container Database prior to terminating it. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -14340,9 +17288,6 @@ def stop_autonomous_database(self, autonomous_database_id, **kwargs): 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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -14351,28 +17296,27 @@ def stop_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use stop_autonomous_database API. + Click `here `__ to see an example of how to use terminate_autonomous_container_database API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/stop" - method = "POST" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "stop_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "terminate_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14384,8 +17328,7 @@ def stop_autonomous_database(self, autonomous_database_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14399,30 +17342,21 @@ def stop_autonomous_database(self, autonomous_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) - def switchover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Switches over the primary Autonomous Container Database of an Autonomous Data Guard peer association to standby role. The standby Autonomous Container Database associated with autonomousContainerDatabaseDataguardAssociationId assumes the primary Autonomous Container Database role. - - A switchover incurs no data loss. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + Terminates an Autonomous Exadata Infrastructure, which permanently deletes the infrastructure resource and any container databases and databases contained in the resource. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the system is terminated. Oracle recommends that you back up any data in the Autonomous Exadata Infrastructure prior to terminating it. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -14439,14 +17373,14 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use switchover_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use terminate_autonomous_exadata_infrastructure API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/switchover" - method = "POST" + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ @@ -14456,11 +17390,10 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "switchover_autonomous_container_database_dataguard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "terminate_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14486,23 +17419,28 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation") + header_params=header_params) - def switchover_autonomous_database(self, autonomous_database_id, **kwargs): + def terminate_db_system(self, db_system_id, **kwargs): """ - Initiates a switchover of the specified Autonomous Database to the associated standby database. Applicable only to databases with Autonomous Data Guard enabled. + Terminates a DB system and permanently deletes it and any databases running on it, and any storage volumes attached to it. The database data is local to the DB system and will be lost when the system is terminated. Oracle recommends that you back up any data in the DB system prior to terminating it. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - :param str autonomous_database_id: (required) - The database `OCID`__. + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -14511,16 +17449,6 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): 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. - :param str opc_retry_token: (optional) - 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). - - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -14529,29 +17457,27 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use switchover_autonomous_database API. + Click `here `__ to see an example of how to use terminate_db_system API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/switchover" - method = "POST" + resource_path = "/dbSystems/{dbSystemId}" + method = "DELETE" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "switchover_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "terminate_db_system got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14563,9 +17489,7 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-retry-token": kwargs.get("opc_retry_token", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14574,43 +17498,31 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): retry_strategy = kwargs.get('retry_strategy') if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) return retry_strategy.make_retrying_call( self.base_client.call_api, resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params, - response_type="AutonomousDatabase") + header_params=header_params) - def switchover_data_guard_association(self, database_id, data_guard_association_id, switchover_data_guard_association_details, **kwargs): + def update_autonomous_container_database(self, autonomous_container_database_id, update_autonomous_container_database_details, **kwargs): """ - Performs a switchover to transition the primary database of a Data Guard association into a standby role. The - standby database associated with the `dataGuardAssociationId` assumes the primary database role. - - A switchover guarantees no data loss. - - - :param str database_id: (required) - The database `OCID`__. + Updates the properties of an Autonomous Container Database, such as the OCPU core count and storage size. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) - Request to swtichover a primary to a standby. + :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) + Request to update the properties of an Autonomous Container Database. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -14625,14 +17537,14 @@ def switchover_data_guard_association(self, database_id, data_guard_association_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DataGuardAssociation` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use switchover_data_guard_association API. + Click `here `__ to see an example of how to use update_autonomous_container_database API. """ - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/switchover" - method = "POST" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ @@ -14642,11 +17554,10 @@ def switchover_data_guard_association(self, database_id, data_guard_association_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "switchover_data_guard_association got unknown kwargs: {!r}".format(extra_kwargs)) + "update_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14673,32 +17584,38 @@ def switchover_data_guard_association(self, database_id, data_guard_association_ method=method, path_params=path_params, header_params=header_params, - body=switchover_data_guard_association_details, - response_type="DataGuardAssociation") + body=update_autonomous_container_database_details, + response_type="AutonomousContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=switchover_data_guard_association_details, - response_type="DataGuardAssociation") + body=update_autonomous_container_database_details, + response_type="AutonomousContainerDatabase") - def terminate_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def update_autonomous_database(self, autonomous_database_id, update_autonomous_database_details, **kwargs): """ - Terminates an Autonomous Container Database, which permanently deletes the container database and any databases within the container database. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the container database is terminated. Oracle recommends that you back up any data in the Autonomous Container Database prior to terminating it. + Updates one or more attributes of the specified Autonomous Database. See the UpdateAutonomousDatabaseDetails resource for a full list of attributes that can be updated. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) + Request to update the properties of an Autonomous Database. + :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -14707,27 +17624,28 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use terminate_autonomous_container_database API. + Click `here `__ to see an example of how to use update_autonomous_database API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" - method = "DELETE" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" + method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "terminate_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + "update_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14739,7 +17657,8 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14753,28 +17672,28 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_details, + response_type="AutonomousDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_details, + response_type="AutonomousDatabase") - def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): + def update_autonomous_database_regional_wallet(self, update_autonomous_database_wallet_details, **kwargs): """ - Terminates an Autonomous Exadata Infrastructure, which permanently deletes the infrastructure resource and any container databases and databases contained in the resource. The database data is local to the Autonomous Exadata Infrastructure and will be lost when the system is terminated. Oracle recommends that you back up any data in the Autonomous Exadata Infrastructure prior to terminating it. - + Updates the Autonomous Database regional wallet. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) + Request to update the properties of Autonomous Database regional wallet. - :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -14788,35 +17707,25 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use terminate_autonomous_exadata_infrastructure API. + Click `here `__ to see an example of how to use update_autonomous_database_regional_wallet API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" - method = "DELETE" + resource_path = "/autonomousDatabases/wallet" + method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "terminate_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) - - path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id - } - - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - - for (k, v) in six.iteritems(path_params): - if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): - raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + "update_autonomous_database_regional_wallet got unknown kwargs: {!r}".format(extra_kwargs)) header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14829,36 +17738,30 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_wallet_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_wallet_details) - def terminate_db_system(self, db_system_id, **kwargs): + def update_autonomous_database_wallet(self, autonomous_database_id, update_autonomous_database_wallet_details, **kwargs): """ - Terminates a DB system and permanently deletes it and any databases running on it, and any storage volumes attached to it. The database data is local to the DB system and will be lost when the system is terminated. Oracle recommends that you back up any data in the DB system prior to terminating it. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Updates the wallet for the specified Autonomous Database. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str if_match: (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. + :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) + Request to update the properties of an Autonomous Database wallet. + + :param str opc_request_id: (optional) + Unique identifier for the request. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -14872,23 +17775,23 @@ def terminate_db_system(self, db_system_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use terminate_db_system API. + Click `here `__ to see an example of how to use update_autonomous_database_wallet API. """ - resource_path = "/dbSystems/{dbSystemId}" - method = "DELETE" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" + method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "terminate_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + "update_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14900,7 +17803,7 @@ def terminate_db_system(self, db_system_id, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14914,26 +17817,28 @@ def terminate_db_system(self, db_system_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_wallet_details) else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, - header_params=header_params) + header_params=header_params, + body=update_autonomous_database_wallet_details) - def update_autonomous_container_database(self, autonomous_container_database_id, update_autonomous_container_database_details, **kwargs): + def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **kwargs): """ - Updates the properties of an Autonomous Container Database, such as the OCPU core count and storage size. + Updates the properties of an Autonomous Exadata Infrastructure, such as the CPU core count. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) - Request to update the properties of an Autonomous Container Database. + :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) + Request to update the properties of a Autonomous Exadata Infrastructure. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -14948,13 +17853,13 @@ def update_autonomous_container_database(self, autonomous_container_database_id, To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_container_database API. + Click `here `__ to see an example of how to use update_autonomous_exadata_infrastructure API. """ - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" method = "PUT" # Don't accept unknown kwargs @@ -14965,10 +17870,10 @@ def update_autonomous_container_database(self, autonomous_container_database_id, extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_container_database got unknown kwargs: {!r}".format(extra_kwargs)) + "update_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14995,29 +17900,29 @@ def update_autonomous_container_database(self, autonomous_container_database_id, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_container_database_details, - response_type="AutonomousContainerDatabase") + body=update_autonomous_exadata_infrastructures_details, + response_type="AutonomousExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_container_database_details, - response_type="AutonomousContainerDatabase") + body=update_autonomous_exadata_infrastructures_details, + response_type="AutonomousExadataInfrastructure") - def update_autonomous_database(self, autonomous_database_id, update_autonomous_database_details, **kwargs): + def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **kwargs): """ - Updates one or more attributes of the specified Autonomous Database. See the UpdateAutonomousDatabaseDetails resource for a full list of attributes that can be updated. + Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) - Request to update the properties of an Autonomous Database. + :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) + Request to update the attributes of an Autonomous VM cluster. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -15035,13 +17940,13 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_d To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_database API. + Click `here `__ to see an example of how to use update_autonomous_vm_cluster API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "PUT" # Don't accept unknown kwargs @@ -15053,10 +17958,10 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_d extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_database got unknown kwargs: {!r}".format(extra_kwargs)) + "update_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15084,24 +17989,37 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_d method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_details, - response_type="AutonomousDatabase") + body=update_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_details, - response_type="AutonomousDatabase") + body=update_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster") - def update_autonomous_database_regional_wallet(self, update_autonomous_database_wallet_details, **kwargs): + def update_backup_destination(self, backup_destination_id, update_backup_destination_details, **kwargs): """ - Updates the Autonomous Database regional wallet. + If no database is associated with the backup destination: + - For a RECOVERY_APPLIANCE backup destination, updates the connection string and/or the list of VPC users. + - For an NFS backup destination, updates the NFS location. + + + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) - Request to update the properties of Autonomous Database regional wallet. + :param oci.database.models.UpdateBackupDestinationDetails update_backup_destination_details: (required) + For a RECOVERY_APPLIANCE backup destination, request to update the connection string and/or the list of VPC users. + For an NFS backup destination, request to update the NFS location. + + :param str if_match: (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. :param str opc_request_id: (optional) Unique identifier for the request. @@ -15114,28 +18032,40 @@ def update_autonomous_database_regional_wallet(self, update_autonomous_database_ To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_database_regional_wallet API. + Click `here `__ to see an example of how to use update_backup_destination API. """ - resource_path = "/autonomousDatabases/wallet" + resource_path = "/backupDestinations/{backupDestinationId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "if_match", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_database_regional_wallet got unknown kwargs: {!r}".format(extra_kwargs)) + "update_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "backupDestinationId": backup_destination_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15149,27 +18079,36 @@ def update_autonomous_database_regional_wallet(self, update_autonomous_database_ self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=update_autonomous_database_wallet_details) + body=update_backup_destination_details, + response_type="BackupDestination") else: return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=update_autonomous_database_wallet_details) + body=update_backup_destination_details, + response_type="BackupDestination") - def update_autonomous_database_wallet(self, autonomous_database_id, update_autonomous_database_wallet_details, **kwargs): + def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **kwargs): """ - Updates the wallet for the specified Autonomous Database. + Updates the Cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) - Request to update the properties of an Autonomous Database wallet. + :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) + Request to update the properties of an cloud Exadata infrastructure resource. + + :param str if_match: (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. :param str opc_request_id: (optional) Unique identifier for the request. @@ -15182,27 +18121,28 @@ def update_autonomous_database_wallet(self, autonomous_database_id, update_auton To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type None + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_database_wallet API. + Click `here `__ to see an example of how to use update_cloud_exadata_infrastructure API. """ - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "if_match", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_database_wallet got unknown kwargs: {!r}".format(extra_kwargs)) + "update_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousDatabaseId": autonomous_database_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15214,6 +18154,7 @@ def update_autonomous_database_wallet(self, autonomous_database_id, update_auton header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15229,33 +18170,38 @@ def update_autonomous_database_wallet(self, autonomous_database_id, update_auton method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_wallet_details) + body=update_cloud_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_wallet_details) + body=update_cloud_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure") - def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **kwargs): + def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, **kwargs): """ - Updates the properties of an Autonomous Exadata Infrastructure, such as the CPU core count. + Updates the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) - Request to update the properties of a Autonomous Exadata Infrastructure. + :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) + Request to update the attributes of a cloud VM cluster. :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15264,27 +18210,28 @@ def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastruc To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_exadata_infrastructure API. + Click `here `__ to see an example of how to use update_cloud_vm_cluster API. """ - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "update_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15296,7 +18243,8 @@ def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastruc header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15311,38 +18259,38 @@ def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastruc method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_exadata_infrastructures_details, - response_type="AutonomousExadataInfrastructure") + body=update_cloud_vm_cluster_details, + response_type="CloudVmCluster") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_exadata_infrastructures_details, - response_type="AutonomousExadataInfrastructure") + body=update_cloud_vm_cluster_details, + response_type="CloudVmCluster") - def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **kwargs): + def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **kwargs): """ - Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system. + Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance. - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) - Request to update the attributes of an Autonomous VM cluster. + :param oci.database.models.ExadataIormConfigUpdateDetails cloud_vm_cluster_iorm_config_update_details: (required) + Request to perform database update. + + :param str opc_request_id: (optional) + Unique identifier for the request. :param str if_match: (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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15351,28 +18299,28 @@ def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomo To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use update_cloud_vm_cluster_iorm_config API. """ - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" + resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "opc_request_id", + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_autonomous_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "update_cloud_vm_cluster_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15384,8 +18332,8 @@ def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomo header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15400,41 +18348,35 @@ def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomo method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster") + body=cloud_vm_cluster_iorm_config_update_details, + response_type="ExadataIormConfig") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster") + body=cloud_vm_cluster_iorm_config_update_details, + response_type="ExadataIormConfig") - def update_backup_destination(self, backup_destination_id, update_backup_destination_details, **kwargs): + def update_database(self, database_id, update_database_details, **kwargs): """ - If no database is associated with the backup destination: - - For a RECOVERY_APPLIANCE backup destination, updates the connection string and/or the list of VPC users. - - For an NFS backup destination, updates the NFS location. + Update the specified database based on the request parameters provided. - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateBackupDestinationDetails update_backup_destination_details: (required) - For a RECOVERY_APPLIANCE backup destination, request to update the connection string and/or the list of VPC users. - For an NFS backup destination, request to update the NFS location. + :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) + Request to perform database update. :param str if_match: (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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15443,28 +18385,27 @@ def update_backup_destination(self, backup_destination_id, update_backup_destina To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.BackupDestination` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_backup_destination API. + Click `here `__ to see an example of how to use update_database API. """ - resource_path = "/backupDestinations/{backupDestinationId}" + resource_path = "/databases/{databaseId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_backup_destination got unknown kwargs: {!r}".format(extra_kwargs)) + "update_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "backupDestinationId": backup_destination_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15476,8 +18417,7 @@ def update_backup_destination(self, backup_destination_id, update_backup_destina header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15492,38 +18432,35 @@ def update_backup_destination(self, backup_destination_id, update_backup_destina method=method, path_params=path_params, header_params=header_params, - body=update_backup_destination_details, - response_type="BackupDestination") + body=update_database_details, + response_type="Database") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_backup_destination_details, - response_type="BackupDestination") + body=update_database_details, + response_type="Database") - def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **kwargs): + def update_database_software_image(self, database_software_image_id, update_database_software_image_details, **kwargs): """ - Updates the Cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances only. + Updates the properties of a Database Software Image, like Display Nmae - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + :param str database_software_image_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) - Request to update the properties of an cloud Exadata infrastructure resource. + :param oci.database.models.UpdateDatabaseSoftwareImageDetails update_database_software_image_details: (required) + Request to update the properties of a DB system. :param str if_match: (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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15532,28 +18469,27 @@ def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, u To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_cloud_exadata_infrastructure API. + Click `here `__ to see an example of how to use update_database_software_image API. """ - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_cloud_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "update_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15565,8 +18501,7 @@ def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, u header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15581,38 +18516,35 @@ def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, u method=method, path_params=path_params, header_params=header_params, - body=update_cloud_exadata_infrastructure_details, - response_type="CloudExadataInfrastructure") + body=update_database_software_image_details, + response_type="DatabaseSoftwareImage") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_cloud_exadata_infrastructure_details, - response_type="CloudExadataInfrastructure") + body=update_database_software_image_details, + response_type="DatabaseSoftwareImage") - def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, **kwargs): + def update_db_home(self, db_home_id, update_db_home_details, **kwargs): """ - Updates the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. + Patches the specified Database Home. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) - Request to update the attributes of a cloud VM cluster. + :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) + Request to update the properties of a Database Home. :param str if_match: (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. - :param str opc_request_id: (optional) - Unique identifier for the request. - :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15621,28 +18553,27 @@ def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_d To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudVmCluster` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_cloud_vm_cluster API. + Click `here `__ to see an example of how to use update_db_home API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}" + resource_path = "/dbHomes/{dbHomeId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match", - "opc_request_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_cloud_vm_cluster got unknown kwargs: {!r}".format(extra_kwargs)) + "update_db_home got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15654,8 +18585,7 @@ def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_d header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing), - "opc-request-id": kwargs.get("opc_request_id", missing) + "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15670,32 +18600,36 @@ def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_d method=method, path_params=path_params, header_params=header_params, - body=update_cloud_vm_cluster_details, - response_type="CloudVmCluster") + body=update_db_home_details, + response_type="DbHome") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_cloud_vm_cluster_details, - response_type="CloudVmCluster") + body=update_db_home_details, + response_type="DbHome") - def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **kwargs): + def update_db_system(self, db_system_id, update_db_system_details, **kwargs): """ - Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance. + Updates the properties of the specified DB system. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm - :param oci.database.models.ExadataIormConfigUpdateDetails cloud_vm_cluster_iorm_config_update_details: (required) - Request to perform database update. - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) + Request to update the properties of a DB system. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -15710,28 +18644,27 @@ def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_clus To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_cloud_vm_cluster_iorm_config API. + Click `here `__ to see an example of how to use update_db_system API. """ - resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" + resource_path = "/dbSystems/{dbSystemId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_cloud_vm_cluster_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) + "update_db_system got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15743,7 +18676,6 @@ def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_clus header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15759,35 +18691,39 @@ def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_clus method=method, path_params=path_params, header_params=header_params, - body=cloud_vm_cluster_iorm_config_update_details, - response_type="ExadataIormConfig") + body=update_db_system_details, + response_type="DbSystem") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=cloud_vm_cluster_iorm_config_update_details, - response_type="ExadataIormConfig") + body=update_db_system_details, + response_type="DbSystem") - def update_database(self, database_id, update_database_details, **kwargs): + def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadata_infrastructure_details, **kwargs): """ - Update the specified database based on the request parameters provided. + Updates the Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. + To update an Exadata Cloud Service infrastructure resource, use the :func:`update_cloud_exadata_infrastructure` operation. - :param str database_id: (required) - The database `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) - Request to perform database update. + :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) + Request to update the properties of an Exadata Cloud@Customer infrastructure. :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15796,27 +18732,28 @@ def update_database(self, database_id, update_database_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.Database` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_database API. + Click `here `__ to see an example of how to use update_exadata_infrastructure API. """ - resource_path = "/databases/{databaseId}" + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_database got unknown kwargs: {!r}".format(extra_kwargs)) + "update_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseId": database_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15828,7 +18765,8 @@ def update_database(self, database_id, update_database_details, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15843,29 +18781,42 @@ def update_database(self, database_id, update_database_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_database_details, - response_type="Database") + body=update_exadata_infrastructure_details, + response_type="ExadataInfrastructure") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_database_details, - response_type="Database") + body=update_exadata_infrastructure_details, + response_type="ExadataInfrastructure") - def update_database_software_image(self, database_software_image_id, update_database_software_image_details, **kwargs): + def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_details, **kwargs): """ - Updates the properties of a Database Software Image, like Display Nmae + Updates IORM settings for the specified Exadata DB system. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - :param str database_software_image_id: (required) + The :func:`update_cloud_vm_cluster_iorm_config` API is used for Exadata systems using the + new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param str db_system_id: (required) The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDatabaseSoftwareImageDetails update_database_software_image_details: (required) - Request to update the properties of a DB system. + :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) + Request to perform database update. + + :param str opc_request_id: (optional) + Unique identifier for the request. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -15880,27 +18831,28 @@ def update_database_software_image(self, database_software_image_id, update_data To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DatabaseSoftwareImage` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_database_software_image API. + Click `here `__ to see an example of how to use update_exadata_iorm_config API. """ - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", + "opc_request_id", "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_database_software_image got unknown kwargs: {!r}".format(extra_kwargs)) + "update_exadata_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "databaseSoftwareImageId": database_software_image_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15912,6 +18864,7 @@ def update_database_software_image(self, database_software_image_id, update_data header_params = { "accept": "application/json", "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), "if-match": kwargs.get("if_match", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -15927,35 +18880,41 @@ def update_database_software_image(self, database_software_image_id, update_data method=method, path_params=path_params, header_params=header_params, - body=update_database_software_image_details, - response_type="DatabaseSoftwareImage") + body=exadata_iorm_config_update_details, + response_type="ExadataIormConfig") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_database_software_image_details, - response_type="DatabaseSoftwareImage") + body=exadata_iorm_config_update_details, + response_type="ExadataIormConfig") - def update_db_home(self, db_home_id, update_db_home_details, **kwargs): + def update_external_container_database(self, external_container_database_id, update_external_container_database_details, **kwargs): """ - Patches the specified Database Home. + Updates the properties of + an :func:`create_external_container_database_details` resource, + such as the display name. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) - Request to update the properties of a Database Home. + :param oci.database.models.UpdateExternalContainerDatabaseDetails update_external_container_database_details: (required) + Request to update the properties of an + :func:`create_external_container_database_details` resource. :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -15964,27 +18923,28 @@ def update_db_home(self, db_home_id, update_db_home_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbHome` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_db_home API. + Click `here `__ to see an example of how to use update_external_container_database API. """ - resource_path = "/dbHomes/{dbHomeId}" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_db_home got unknown kwargs: {!r}".format(extra_kwargs)) + "update_external_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbHomeId": db_home_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15996,7 +18956,8 @@ def update_db_home(self, db_home_id, update_db_home_details, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -16011,42 +18972,39 @@ def update_db_home(self, db_home_id, update_db_home_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_db_home_details, - response_type="DbHome") + body=update_external_container_database_details, + response_type="ExternalContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_db_home_details, - response_type="DbHome") + body=update_external_container_database_details, + response_type="ExternalContainerDatabase") - def update_db_system(self, db_system_id, update_db_system_details, **kwargs): + def update_external_database_connector(self, external_database_connector_id, update_external_database_connector_details, **kwargs): """ - Updates the properties of the specified DB system. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + Updates the properties of an external database connector, such as the display name. - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm - - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) - Request to update the properties of a DB system. + :param oci.database.models.UpdateExternalDatabaseConnectorDetails update_external_database_connector_details: (required) + Request to update the properties of an external database connector. :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -16055,27 +19013,28 @@ def update_db_system(self, db_system_id, update_db_system_details, **kwargs): To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystem` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_db_system API. + Click `here `__ to see an example of how to use update_external_database_connector API. """ - resource_path = "/dbSystems/{dbSystemId}" + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_db_system got unknown kwargs: {!r}".format(extra_kwargs)) + "update_external_database_connector got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "externalDatabaseConnectorId": external_database_connector_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16087,7 +19046,8 @@ def update_db_system(self, db_system_id, update_db_system_details, **kwargs): header_params = { "accept": "application/json", "content-type": "application/json", - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -16102,30 +19062,29 @@ def update_db_system(self, db_system_id, update_db_system_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_db_system_details, - response_type="DbSystem") + body=update_external_database_connector_details, + response_type="ExternalDatabaseConnector") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_db_system_details, - response_type="DbSystem") + body=update_external_database_connector_details, + response_type="ExternalDatabaseConnector") - def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadata_infrastructure_details, **kwargs): + def update_external_non_container_database(self, external_non_container_database_id, update_external_non_container_database_details, **kwargs): """ - Updates the Exadata infrastructure resource. Applies to Exadata Cloud@Customer instances only. - To update an Exadata Cloud Service infrastructure resource, use the :func:`update_cloud_exadata_infrastructure` operation. + Updates the properties of an external non-container database, such as the display name. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) - Request to update the properties of an Exadata Cloud@Customer infrastructure. + :param oci.database.models.UpdateExternalNonContainerDatabaseDetails update_external_non_container_database_details: (required) + Request to update the properties of an external non-container database. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -16143,13 +19102,13 @@ def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadat To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructure` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_exadata_infrastructure API. + Click `here `__ to see an example of how to use update_external_non_container_database API. """ - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" method = "PUT" # Don't accept unknown kwargs @@ -16161,10 +19120,10 @@ def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadat extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_exadata_infrastructure got unknown kwargs: {!r}".format(extra_kwargs)) + "update_external_non_container_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16192,48 +19151,40 @@ def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadat method=method, path_params=path_params, header_params=header_params, - body=update_exadata_infrastructure_details, - response_type="ExadataInfrastructure") + body=update_external_non_container_database_details, + response_type="ExternalNonContainerDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=update_exadata_infrastructure_details, - response_type="ExadataInfrastructure") + body=update_external_non_container_database_details, + response_type="ExternalNonContainerDatabase") - def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_details, **kwargs): + def update_external_pluggable_database(self, external_pluggable_database_id, update_external_pluggable_database_details, **kwargs): """ - Updates IORM settings for the specified Exadata DB system. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. - - The :func:`update_cloud_vm_cluster_iorm_config` API is used for Exadata systems using the - new resource model. - - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Updates the properties of an + :func:`create_external_pluggable_database_details` resource, + such as the display name. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) - Request to perform database update. - - :param str opc_request_id: (optional) - Unique identifier for the request. + :param oci.database.models.UpdateExternalPluggableDatabaseDetails update_external_pluggable_database_details: (required) + Request to update the properties of an external pluggable database resource. :param str if_match: (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. + :param str opc_request_id: (optional) + Unique identifier for the request. + :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -16242,28 +19193,28 @@ def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_de To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataIormConfig` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_exadata_iorm_config API. + Click `here `__ to see an example of how to use update_external_pluggable_database API. """ - resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" method = "PUT" # Don't accept unknown kwargs expected_kwargs = [ "retry_strategy", - "opc_request_id", - "if_match" + "if_match", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "update_exadata_iorm_config got unknown kwargs: {!r}".format(extra_kwargs)) + "update_external_pluggable_database got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "dbSystemId": db_system_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16275,8 +19226,8 @@ def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_de header_params = { "accept": "application/json", "content-type": "application/json", - "opc-request-id": kwargs.get("opc_request_id", missing), - "if-match": kwargs.get("if_match", missing) + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -16291,16 +19242,16 @@ def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_de method=method, path_params=path_params, header_params=header_params, - body=exadata_iorm_config_update_details, - response_type="ExadataIormConfig") + body=update_external_pluggable_database_details, + response_type="ExternalPluggableDatabase") else: return self.base_client.call_api( resource_path=resource_path, method=method, path_params=path_params, header_params=header_params, - body=exadata_iorm_config_update_details, - response_type="ExadataIormConfig") + body=update_external_pluggable_database_details, + response_type="ExternalPluggableDatabase") def update_key_store(self, key_store_id, update_key_store_details, **kwargs): """ diff --git a/src/oci/database/database_client_composite_operations.py b/src/oci/database/database_client_composite_operations.py index 7d026d2d03..87e642c96a 100644 --- a/src/oci/database/database_client_composite_operations.py +++ b/src/oci/database/database_client_composite_operations.py @@ -600,6 +600,128 @@ def change_exadata_infrastructure_compartment_and_wait_for_work_request(self, ch except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def change_external_container_database_compartment_and_wait_for_work_request(self, change_compartment_details, external_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.change_external_container_database_compartment` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the external container database to a different compartment. + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.change_external_container_database_compartment` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.change_external_container_database_compartment(change_compartment_details, external_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def change_external_non_container_database_compartment_and_wait_for_work_request(self, change_compartment_details, external_non_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.change_external_non_container_database_compartment` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the external non-container database to a different compartment. + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.change_external_non_container_database_compartment` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.change_external_non_container_database_compartment(change_compartment_details, external_non_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def change_external_pluggable_database_compartment_and_wait_for_work_request(self, change_compartment_details, external_pluggable_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.change_external_pluggable_database_compartment` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the + :func:`create_external_pluggable_database_details` resource + to a different compartment. + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.change_external_pluggable_database_compartment` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.change_external_pluggable_database_compartment(change_compartment_details, external_pluggable_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def change_key_store_compartment_and_wait_for_work_request(self, change_key_store_compartment_details, key_store_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.change_key_store_compartment` and waits for the oci.work_requests.models.WorkRequest @@ -680,6 +802,44 @@ def change_vm_cluster_compartment_and_wait_for_work_request(self, change_vm_clus except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def check_external_database_connector_connection_status_and_wait_for_work_request(self, external_database_connector_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.check_external_database_connector_connection_status` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.check_external_database_connector_connection_status` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.check_external_database_connector_connection_status(external_database_connector_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def complete_external_backup_job_and_wait_for_work_request(self, backup_id, complete_external_backup_job_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.complete_external_backup_job` and waits for the oci.work_requests.models.WorkRequest @@ -1730,25 +1890,60 @@ def create_external_backup_job_and_wait_for_work_request(self, create_external_b except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_key_store_and_wait_for_state(self, create_key_store_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_container_database_and_wait_for_work_request(self, create_external_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_key_store` and waits for the :py:class:`~oci.database.models.KeyStore` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_external_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreateKeyStoreDetails create_key_store_details: (required) - Request to create a new key store. + :param oci.database.models.CreateExternalContainerDatabaseDetails create_external_container_database_details: (required) + Request to create a new external container database resource. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_container_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.create_external_container_database(create_external_container_database_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_external_container_database_and_wait_for_state(self, create_external_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_external_container_database` and waits for the :py:class:`~oci.database.models.ExternalContainerDatabase` acted upon + to enter the given state(s). + + :param oci.database.models.CreateExternalContainerDatabaseDetails create_external_container_database_details: (required) + Request to create a new external container database resource. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.KeyStore.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_key_store` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.create_key_store(create_key_store_details, **operation_kwargs) + operation_result = self.client.create_external_container_database(create_external_container_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -1758,7 +1953,7 @@ def create_key_store_and_wait_for_state(self, create_key_store_details, wait_for try: waiter_result = oci.wait_until( self.client, - self.client.get_key_store(wait_for_resource_id), + self.client.get_external_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -1768,27 +1963,26 @@ def create_key_store_and_wait_for_state(self, create_key_store_details, wait_for except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_vm_cluster_and_wait_for_work_request(self, create_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_database_connector_and_wait_for_work_request(self, create_external_database_connector_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_external_database_connector` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) - Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. - See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. + :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) + Request to create a connector to an external database. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_database_connector` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.create_vm_cluster(create_vm_cluster_details, **operation_kwargs) + operation_result = self.client.create_external_database_connector(create_external_database_connector_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -1804,26 +1998,25 @@ def create_vm_cluster_and_wait_for_work_request(self, create_vm_cluster_details, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_vm_cluster_and_wait_for_state(self, create_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_database_connector_and_wait_for_state(self, create_external_database_connector_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster` and waits for the :py:class:`~oci.database.models.VmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_external_database_connector` and waits for the :py:class:`~oci.database.models.ExternalDatabaseConnector` acted upon to enter the given state(s). - :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) - Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. - See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. + :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) + Request to create a connector to an external database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.VmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalDatabaseConnector.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_database_connector` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.create_vm_cluster(create_vm_cluster_details, **operation_kwargs) + operation_result = self.client.create_external_database_connector(create_external_database_connector_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -1833,7 +2026,7 @@ def create_vm_cluster_and_wait_for_state(self, create_vm_cluster_details, wait_f try: waiter_result = oci.wait_until( self.client, - self.client.get_vm_cluster(wait_for_resource_id), + self.client.get_external_database_connector(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -1843,31 +2036,26 @@ def create_vm_cluster_and_wait_for_state(self, create_vm_cluster_details, wait_f except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastructure_id, vm_cluster_network_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_non_container_database_and_wait_for_work_request(self, create_external_non_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) - Request to create the Cloud@Customer VM cluster network. + :param oci.database.models.CreateExternalNonContainerDatabaseDetails create_external_non_container_database_details: (required) + Request to create a new external non-container database. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.create_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_details, **operation_kwargs) + operation_result = self.client.create_external_non_container_database(create_external_non_container_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -1883,30 +2071,25 @@ def create_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastruc except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_vm_cluster_network_and_wait_for_state(self, exadata_infrastructure_id, vm_cluster_network_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_non_container_database_and_wait_for_state(self, create_external_non_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` and waits for the :py:class:`~oci.database.models.VmClusterNetwork` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` and waits for the :py:class:`~oci.database.models.ExternalNonContainerDatabase` acted upon to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) - Request to create the Cloud@Customer VM cluster network. + :param oci.database.models.CreateExternalNonContainerDatabaseDetails create_external_non_container_database_details: (required) + Request to create a new external non-container database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.VmClusterNetwork.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalNonContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.create_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_details, **operation_kwargs) + operation_result = self.client.create_external_non_container_database(create_external_non_container_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -1916,7 +2099,7 @@ def create_vm_cluster_network_and_wait_for_state(self, exadata_infrastructure_id try: waiter_result = oci.wait_until( self.client, - self.client.get_vm_cluster_network(wait_for_resource_id), + self.client.get_external_non_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -1926,33 +2109,26 @@ def create_vm_cluster_network_and_wait_for_state(self, exadata_infrastructure_id except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def db_node_action_and_wait_for_work_request(self, db_node_id, action, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_pluggable_database_and_wait_for_work_request(self, create_external_pluggable_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.db_node_action` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_external_pluggable_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_node_id: (required) - The database node `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str action: (required) - The action to perform on the DB Node. - - Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + :param oci.database.models.CreateExternalPluggableDatabaseDetails create_external_pluggable_database_details: (required) + Request to create a new external pluggable database. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.db_node_action` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_pluggable_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.db_node_action(db_node_id, action, **operation_kwargs) + operation_result = self.client.create_external_pluggable_database(create_external_pluggable_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -1968,32 +2144,25 @@ def db_node_action_and_wait_for_work_request(self, db_node_id, action, work_requ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def db_node_action_and_wait_for_state(self, db_node_id, action, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_external_pluggable_database_and_wait_for_state(self, create_external_pluggable_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.db_node_action` and waits for the :py:class:`~oci.database.models.DbNode` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_external_pluggable_database` and waits for the :py:class:`~oci.database.models.ExternalPluggableDatabase` acted upon to enter the given state(s). - :param str db_node_id: (required) - The database node `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str action: (required) - The action to perform on the DB Node. - - Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + :param oci.database.models.CreateExternalPluggableDatabaseDetails create_external_pluggable_database_details: (required) + Request to create a new external pluggable database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbNode.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalPluggableDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.db_node_action` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_pluggable_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.db_node_action(db_node_id, action, **operation_kwargs) + operation_result = self.client.create_external_pluggable_database(create_external_pluggable_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -2003,7 +2172,7 @@ def db_node_action_and_wait_for_state(self, db_node_id, action, wait_for_states= try: waiter_result = oci.wait_until( self.client, - self.client.get_db_node(wait_for_resource_id), + self.client.get_external_pluggable_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -2013,65 +2182,65 @@ def db_node_action_and_wait_for_state(self, db_node_id, action, wait_for_states= except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_key_store_and_wait_for_state(self, create_key_store_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_key_store` and waits for the :py:class:`~oci.database.models.KeyStore` acted upon to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateKeyStoreDetails create_key_store_details: (required) + Request to create a new key store. - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.KeyStore.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_key_store` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_autonomous_database(autonomous_database_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.create_key_store(create_key_store_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_key_store(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_vm_cluster_and_wait_for_work_request(self, create_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_autonomous_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) + Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. + See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_autonomous_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_autonomous_vm_cluster(autonomous_vm_cluster_id, **operation_kwargs) + operation_result = self.client.create_vm_cluster(create_vm_cluster_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2087,28 +2256,70 @@ def delete_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_c except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_backup_and_wait_for_work_request(self, backup_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_vm_cluster_and_wait_for_state(self, create_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_backup` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster` and waits for the :py:class:`~oci.database.models.VmCluster` acted upon to enter the given state(s). - :param str backup_id: (required) - The backup `OCID`__. + :param oci.database.models.CreateVmClusterDetails create_vm_cluster_details: (required) + Request to create a VM cluster. Applies to Exadata Cloud@Customer instances only. + See :func:`create_cloud_vm_cluster_details` for details on creating a cloud VM cluster in an Exadata Cloud Service instance. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.VmCluster.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.create_vm_cluster(create_vm_cluster_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_vm_cluster(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastructure_id, vm_cluster_network_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) + Request to create the Cloud@Customer VM cluster network. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_backup` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_backup(backup_id, **operation_kwargs) + operation_result = self.client.create_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2124,47 +2335,41 @@ def delete_backup_and_wait_for_work_request(self, backup_id, work_request_states except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_backup_destination_and_wait_for_state(self, backup_destination_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_vm_cluster_network_and_wait_for_state(self, exadata_infrastructure_id, vm_cluster_network_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_backup_destination` and waits for the :py:class:`~oci.database.models.BackupDestination` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` and waits for the :py:class:`~oci.database.models.VmClusterNetwork` acted upon to enter the given state(s). - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.VmClusterNetworkDetails vm_cluster_network_details: (required) + Request to create the Cloud@Customer VM cluster network. + :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.BackupDestination.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.VmClusterNetwork.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_backup_destination` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_vm_cluster_network` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - initial_get_result = self.client.get_backup_destination(backup_destination_id) - operation_result = None - try: - operation_result = self.client.delete_backup_destination(backup_destination_id, **operation_kwargs) - except oci.exceptions.ServiceError as e: - if e.status == 404: - return WAIT_RESOURCE_NOT_FOUND - else: - raise e - + operation_result = self.client.create_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - initial_get_result, + self.client.get_vm_cluster_network(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, - succeed_on_not_found=True, **waiter_kwargs ) result_to_return = waiter_result @@ -2173,28 +2378,33 @@ def delete_backup_destination_and_wait_for_state(self, backup_destination_id, wa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def db_node_action_and_wait_for_work_request(self, db_node_id, action, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_cloud_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.db_node_action` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str action: (required) + The action to perform on the DB Node. + + Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_cloud_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.db_node_action` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, **operation_kwargs) + operation_result = self.client.db_node_action(db_node_id, action, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2210,49 +2420,57 @@ def delete_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_ex except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_cloud_vm_cluster_and_wait_for_work_request(self, cloud_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def db_node_action_and_wait_for_state(self, db_node_id, action, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.db_node_action` and waits for the :py:class:`~oci.database.models.DbNode` acted upon to enter the given state(s). - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param str action: (required) + The action to perform on the DB Node. + + Allowed values are: "STOP", "START", "SOFTRESET", "RESET" + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbNode.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_cloud_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.db_node_action` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_cloud_vm_cluster(cloud_vm_cluster_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.db_node_action(db_node_id, action, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_db_node(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_database_and_wait_for_work_request(self, database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2262,13 +2480,13 @@ def delete_database_and_wait_for_work_request(self, database_id, work_request_st Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_database(database_id, **operation_kwargs) + operation_result = self.client.delete_autonomous_database(autonomous_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2284,13 +2502,13 @@ def delete_database_and_wait_for_work_request(self, database_id, work_request_st except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_database_software_image_and_wait_for_work_request(self, database_software_image_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_database_software_image` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_autonomous_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_software_image_id: (required) - The DB system `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2299,13 +2517,13 @@ def delete_database_software_image_and_wait_for_work_request(self, database_soft Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_database_software_image` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_autonomous_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_database_software_image(database_software_image_id, **operation_kwargs) + operation_result = self.client.delete_autonomous_vm_cluster(autonomous_vm_cluster_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2321,13 +2539,13 @@ def delete_database_software_image_and_wait_for_work_request(self, database_soft except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_db_home_and_wait_for_work_request(self, db_home_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_backup_and_wait_for_work_request(self, backup_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_db_home` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_backup` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str backup_id: (required) + The backup `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2336,13 +2554,13 @@ def delete_db_home_and_wait_for_work_request(self, db_home_id, work_request_stat Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_db_home` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_backup` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_db_home(db_home_id, **operation_kwargs) + operation_result = self.client.delete_backup(backup_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2358,99 +2576,62 @@ def delete_db_home_and_wait_for_work_request(self, db_home_id, work_request_stat except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_exadata_infrastructure_and_wait_for_work_request(self, exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_backup_destination_and_wait_for_state(self, backup_destination_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_backup_destination` and waits for the :py:class:`~oci.database.models.BackupDestination` acted upon to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.BackupDestination.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_backup_destination` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_exadata_infrastructure(exadata_infrastructure_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + initial_get_result = self.client.get_backup_destination(backup_destination_id) + operation_result = None + try: + operation_result = self.client.delete_backup_destination(backup_destination_id, **operation_kwargs) + except oci.exceptions.ServiceError as e: + if e.status == 404: + return WAIT_RESOURCE_NOT_FOUND + else: + raise e + + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + initial_get_result, + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + succeed_on_not_found=True, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_key_store_and_wait_for_state(self, key_store_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_key_store` and waits for the :py:class:`~oci.database.models.KeyStore` acted upon + Calls :py:func:`~oci.database.DatabaseClient.delete_cloud_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str key_store_id: (required) - The `OCID`__ of the key store. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.KeyStore.lifecycle_state` - - :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_key_store` - - :param dict waiter_kwargs: - A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` - as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait - """ - initial_get_result = self.client.get_key_store(key_store_id) - operation_result = None - try: - operation_result = self.client.delete_key_store(key_store_id, **operation_kwargs) - except oci.exceptions.ServiceError as e: - if e.status == 404: - return WAIT_RESOURCE_NOT_FOUND - else: - raise e - - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - - try: - waiter_result = oci.wait_until( - self.client, - initial_get_result, - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, - succeed_on_not_found=True, - **waiter_kwargs - ) - result_to_return = waiter_result - - return result_to_return - except Exception as e: - raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - - def delete_vm_cluster_and_wait_for_work_request(self, vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): - """ - Calls :py:func:`~oci.database.DatabaseClient.delete_vm_cluster` and waits for the oci.work_requests.models.WorkRequest - to enter the given state(s). - - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2459,13 +2640,13 @@ def delete_vm_cluster_and_wait_for_work_request(self, vm_cluster_id, work_reques Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_cloud_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_vm_cluster(vm_cluster_id, **operation_kwargs) + operation_result = self.client.delete_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2481,18 +2662,13 @@ def delete_vm_cluster_and_wait_for_work_request(self, vm_cluster_id, work_reques except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def delete_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastructure_id, vm_cluster_network_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_cloud_vm_cluster_and_wait_for_work_request(self, cloud_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.delete_vm_cluster_network` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2501,13 +2677,13 @@ def delete_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastruc Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_vm_cluster_network` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_cloud_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.delete_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, **operation_kwargs) + operation_result = self.client.delete_cloud_vm_cluster(cloud_vm_cluster_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2523,12 +2699,12 @@ def delete_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastruc except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def deregister_autonomous_database_data_safe_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_database_and_wait_for_work_request(self, database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.deregister_autonomous_database_data_safe` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) + :param str database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2538,13 +2714,13 @@ def deregister_autonomous_database_data_safe_and_wait_for_work_request(self, aut Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.deregister_autonomous_database_data_safe` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.deregister_autonomous_database_data_safe(autonomous_database_id, **operation_kwargs) + operation_result = self.client.delete_database(database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2560,13 +2736,13 @@ def deregister_autonomous_database_data_safe_and_wait_for_work_request(self, aut except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def disable_autonomous_database_operations_insights_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_database_software_image_and_wait_for_work_request(self, database_software_image_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.disable_autonomous_database_operations_insights` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_database_software_image` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str database_software_image_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2575,13 +2751,13 @@ def disable_autonomous_database_operations_insights_and_wait_for_work_request(se Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.disable_autonomous_database_operations_insights` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_database_software_image` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.disable_autonomous_database_operations_insights(autonomous_database_id, **operation_kwargs) + operation_result = self.client.delete_database_software_image(database_software_image_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2597,13 +2773,13 @@ def disable_autonomous_database_operations_insights_and_wait_for_work_request(se except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def enable_autonomous_database_operations_insights_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_db_home_and_wait_for_work_request(self, db_home_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.enable_autonomous_database_operations_insights` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_db_home` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2612,13 +2788,13 @@ def enable_autonomous_database_operations_insights_and_wait_for_work_request(sel Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.enable_autonomous_database_operations_insights` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_db_home` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.enable_autonomous_database_operations_insights(autonomous_database_id, **operation_kwargs) + operation_result = self.client.delete_db_home(db_home_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2634,13 +2810,13 @@ def enable_autonomous_database_operations_insights_and_wait_for_work_request(sel except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def fail_over_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_exadata_infrastructure_and_wait_for_work_request(self, exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2649,13 +2825,13 @@ def fail_over_autonomous_database_and_wait_for_work_request(self, autonomous_dat Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.fail_over_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.delete_exadata_infrastructure(exadata_infrastructure_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2671,58 +2847,51 @@ def fail_over_autonomous_database_and_wait_for_work_request(self, autonomous_dat except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def fail_over_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_external_container_database_and_wait_for_work_request(self, external_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.delete_external_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_external_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.fail_over_autonomous_database(autonomous_database_id, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.delete_external_container_database(external_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_database(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def failover_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_external_database_connector_and_wait_for_work_request(self, external_database_connector_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_external_database_connector` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2731,13 +2900,13 @@ def failover_autonomous_container_database_dataguard_association_and_wait_for_wo Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_external_database_connector` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.failover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + operation_result = self.client.delete_external_database_connector(external_database_connector_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2753,81 +2922,65 @@ def failover_autonomous_container_database_dataguard_association_and_wait_for_wo except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def failover_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_external_non_container_database_and_wait_for_work_request(self, external_non_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.delete_external_non_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_external_non_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.failover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.delete_external_non_container_database(external_non_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def failover_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, failover_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_external_pluggable_database_and_wait_for_work_request(self, external_pluggable_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_external_pluggable_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) - A request to perform a failover, transitioning a standby database into a primary database. - :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_external_pluggable_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.failover_data_guard_association(database_id, data_guard_association_id, failover_data_guard_association_details, **operation_kwargs) + operation_result = self.client.delete_external_pluggable_database(external_pluggable_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2843,46 +2996,47 @@ def failover_data_guard_association_and_wait_for_work_request(self, database_id, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def failover_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, failover_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_key_store_and_wait_for_state(self, key_store_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.delete_key_store` and waits for the :py:class:`~oci.database.models.KeyStore` acted upon to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str key_store_id: (required) + The `OCID`__ of the key store. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) - A request to perform a failover, transitioning a standby database into a primary database. - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.KeyStore.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_key_store` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.failover_data_guard_association(database_id, data_guard_association_id, failover_data_guard_association_details, **operation_kwargs) + initial_get_result = self.client.get_key_store(key_store_id) + operation_result = None + try: + operation_result = self.client.delete_key_store(key_store_id, **operation_kwargs) + except oci.exceptions.ServiceError as e: + if e.status == 404: + return WAIT_RESOURCE_NOT_FOUND + else: + raise e + if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_data_guard_association(wait_for_resource_id), + initial_get_result, evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + succeed_on_not_found=True, **waiter_kwargs ) result_to_return = waiter_result @@ -2891,26 +3045,28 @@ def failover_data_guard_association_and_wait_for_state(self, database_id, data_g except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def launch_autonomous_exadata_infrastructure_and_wait_for_work_request(self, launch_autonomous_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_vm_cluster_and_wait_for_work_request(self, vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.delete_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) - Request to create an Autonomous Exadata Infrastructure resource. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.delete_vm_cluster(vm_cluster_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -2926,25 +3082,908 @@ def launch_autonomous_exadata_infrastructure_and_wait_for_work_request(self, lau except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def launch_autonomous_exadata_infrastructure_and_wait_for_state(self, launch_autonomous_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def delete_vm_cluster_network_and_wait_for_work_request(self, exadata_infrastructure_id, vm_cluster_network_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_vm_cluster_network` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str vm_cluster_network_id: (required) + The VM cluster network `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_vm_cluster_network` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.delete_vm_cluster_network(exadata_infrastructure_id, vm_cluster_network_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def deregister_autonomous_database_data_safe_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.deregister_autonomous_database_data_safe` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.deregister_autonomous_database_data_safe` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.deregister_autonomous_database_data_safe(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def disable_autonomous_database_operations_insights_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.disable_autonomous_database_operations_insights` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.disable_autonomous_database_operations_insights` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.disable_autonomous_database_operations_insights(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def disable_external_container_database_database_management_and_wait_for_work_request(self, external_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.disable_external_container_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.disable_external_container_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.disable_external_container_database_database_management(external_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def disable_external_non_container_database_database_management_and_wait_for_work_request(self, external_non_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.disable_external_non_container_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.disable_external_non_container_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.disable_external_non_container_database_database_management(external_non_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def disable_external_pluggable_database_database_management_and_wait_for_work_request(self, external_pluggable_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.disable_external_pluggable_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.disable_external_pluggable_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.disable_external_pluggable_database_database_management(external_pluggable_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def enable_autonomous_database_operations_insights_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.enable_autonomous_database_operations_insights` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.enable_autonomous_database_operations_insights` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.enable_autonomous_database_operations_insights(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def enable_external_container_database_database_management_and_wait_for_work_request(self, external_container_database_id, enable_external_container_database_database_management_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.enable_external_container_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.EnableExternalContainerDatabaseDatabaseManagementDetails enable_external_container_database_database_management_details: (required) + Request to enable the Database Management Service for an external container database. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.enable_external_container_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.enable_external_container_database_database_management(external_container_database_id, enable_external_container_database_database_management_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def enable_external_non_container_database_database_management_and_wait_for_work_request(self, external_non_container_database_id, enable_external_non_container_database_database_management_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.enable_external_non_container_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.EnableExternalNonContainerDatabaseDatabaseManagementDetails enable_external_non_container_database_database_management_details: (required) + Request to enable the Database Management Service for an external non-container database. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.enable_external_non_container_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.enable_external_non_container_database_database_management(external_non_container_database_id, enable_external_non_container_database_database_management_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def enable_external_pluggable_database_database_management_and_wait_for_work_request(self, external_pluggable_database_id, enable_external_pluggable_database_database_management_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.enable_external_pluggable_database_database_management` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.EnableExternalPluggableDatabaseDatabaseManagementDetails enable_external_pluggable_database_database_management_details: (required) + Request to enable the Database Management Service for an external database. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.enable_external_pluggable_database_database_management` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.enable_external_pluggable_database_database_management(external_pluggable_database_id, enable_external_pluggable_database_database_management_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def fail_over_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.fail_over_autonomous_database(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def fail_over_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.fail_over_autonomous_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.fail_over_autonomous_database(autonomous_database_id, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_autonomous_database(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def failover_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.failover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def failover_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon + to enter the given state(s). + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_autonomous_container_database_dataguard_association` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.failover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def failover_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, failover_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) + A request to perform a failover, transitioning a standby database into a primary database. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.failover_data_guard_association(database_id, data_guard_association_id, failover_data_guard_association_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def failover_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, failover_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon + to enter the given state(s). + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.FailoverDataGuardAssociationDetails failover_data_guard_association_details: (required) + A request to perform a failover, transitioning a standby database into a primary database. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.failover_data_guard_association` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.failover_data_guard_association(database_id, data_guard_association_id, failover_data_guard_association_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_data_guard_association(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def launch_autonomous_exadata_infrastructure_and_wait_for_work_request(self, launch_autonomous_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) + Request to create an Autonomous Exadata Infrastructure resource. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def launch_autonomous_exadata_infrastructure_and_wait_for_state(self, launch_autonomous_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.AutonomousExadataInfrastructure` acted upon + to enter the given state(s). + + :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) + Request to create an Autonomous Exadata Infrastructure resource. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousExadataInfrastructure.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_autonomous_exadata_infrastructure(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def launch_db_system_and_wait_for_work_request(self, launch_db_system_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.launch_db_system` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) + Request to launch a DB system. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_db_system` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.launch_db_system(launch_db_system_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def launch_db_system_and_wait_for_state(self, launch_db_system_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.launch_db_system` and waits for the :py:class:`~oci.database.models.DbSystem` acted upon + to enter the given state(s). + + :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) + Request to launch a DB system. + + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + + For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbSystem.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_db_system` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.launch_db_system(launch_db_system_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_db_system(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def migrate_exadata_db_system_resource_model_and_wait_for_work_request(self, db_system_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.AutonomousExadataInfrastructure` acted upon + Calls :py:func:`~oci.database.DatabaseClient.migrate_exadata_db_system_resource_model` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) - Request to create an Autonomous Exadata Infrastructure resource. + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_exadata_db_system_resource_model` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.migrate_exadata_db_system_resource_model(db_system_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def migrate_vault_key_and_wait_for_work_request(self, database_id, migrate_vault_key_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.migrate_vault_key` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) + Request to change the source of the encryption key for the database. + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_vault_key` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.migrate_vault_key(database_id, migrate_vault_key_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def migrate_vault_key_and_wait_for_state(self, database_id, migrate_vault_key_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.migrate_vault_key` and waits for the :py:class:`~oci.database.models.Database` acted upon + to enter the given state(s). + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) + Request to change the source of the encryption key for the database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousExadataInfrastructure.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_autonomous_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_vault_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.launch_autonomous_exadata_infrastructure(launch_autonomous_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.migrate_vault_key(database_id, migrate_vault_key_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -2954,7 +3993,7 @@ def launch_autonomous_exadata_infrastructure_and_wait_for_state(self, launch_aut try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_exadata_infrastructure(wait_for_resource_id), + self.client.get_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -2964,33 +4003,70 @@ def launch_autonomous_exadata_infrastructure_and_wait_for_state(self, launch_aut except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def launch_db_system_and_wait_for_work_request(self, launch_db_system_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def register_autonomous_database_data_safe_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.launch_db_system` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.register_autonomous_database_data_safe` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) - Request to launch a DB system. + :param str autonomous_database_id: (required) + The database `OCID`__. - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.register_autonomous_database_data_safe` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.register_autonomous_database_data_safe(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def reinstate_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_db_system` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.launch_db_system(launch_db_system_details, **operation_kwargs) + operation_result = self.client.reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3006,32 +4082,32 @@ def launch_db_system_and_wait_for_work_request(self, launch_db_system_details, w except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def launch_db_system_and_wait_for_state(self, launch_db_system_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def reinstate_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.launch_db_system` and waits for the :py:class:`~oci.database.models.DbSystem` acted upon + Calls :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon to enter the given state(s). - :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) - Request to launch a DB system. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - For Exadata Cloud Service instances, support for this API will end on May 15th, 2021. See `Switching an Exadata DB System to the New Resource Model and APIs`__ for details on converting existing Exadata DB systems to the new resource model. + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Concepts/exaflexsystem_topic-resource_model_conversion.htm + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbSystem.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.launch_db_system` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.launch_db_system(launch_db_system_details, **operation_kwargs) + operation_result = self.client.reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3041,7 +4117,7 @@ def launch_db_system_and_wait_for_state(self, launch_db_system_details, wait_for try: waiter_result = oci.wait_until( self.client, - self.client.get_db_system(wait_for_resource_id), + self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3051,68 +4127,121 @@ def launch_db_system_and_wait_for_state(self, launch_db_system_details, wait_for except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def migrate_exadata_db_system_resource_model_and_wait_for_work_request(self, db_system_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def reinstate_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.migrate_exadata_db_system_resource_model` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) + A request to reinstate a database in a standby role. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_exadata_db_system_resource_model` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.reinstate_data_guard_association(database_id, data_guard_association_id, reinstate_data_guard_association_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def reinstate_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon + to enter the given state(s). + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) + A request to reinstate a database in a standby role. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.migrate_exadata_db_system_resource_model(db_system_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.reinstate_data_guard_association(database_id, data_guard_association_id, reinstate_data_guard_association_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_data_guard_association(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def migrate_vault_key_and_wait_for_work_request(self, database_id, migrate_vault_key_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def restart_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.migrate_vault_key` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) - Request to change the source of the encryption key for the database. - :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_vault_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.migrate_vault_key(database_id, migrate_vault_key_details, **operation_kwargs) + operation_result = self.client.restart_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3128,30 +4257,27 @@ def migrate_vault_key_and_wait_for_work_request(self, database_id, migrate_vault except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def migrate_vault_key_and_wait_for_state(self, database_id, migrate_vault_key_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def restart_autonomous_container_database_and_wait_for_state(self, autonomous_container_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.migrate_vault_key` and waits for the :py:class:`~oci.database.models.Database` acted upon + Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) - Request to change the source of the encryption key for the database. - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.migrate_vault_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.migrate_vault_key(database_id, migrate_vault_key_details, **operation_kwargs) + operation_result = self.client.restart_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3161,7 +4287,7 @@ def migrate_vault_key_and_wait_for_state(self, database_id, migrate_vault_key_de try: waiter_result = oci.wait_until( self.client, - self.client.get_database(wait_for_resource_id), + self.client.get_autonomous_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3171,9 +4297,9 @@ def migrate_vault_key_and_wait_for_state(self, database_id, migrate_vault_key_de except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def register_autonomous_database_data_safe_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def restart_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.register_autonomous_database_data_safe` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_database_id: (required) @@ -3186,13 +4312,13 @@ def register_autonomous_database_data_safe_and_wait_for_work_request(self, auton Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.register_autonomous_database_data_safe` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.register_autonomous_database_data_safe(autonomous_database_id, **operation_kwargs) + operation_result = self.client.restart_autonomous_database(autonomous_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3208,33 +4334,71 @@ def register_autonomous_database_data_safe_and_wait_for_work_request(self, auton except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def reinstate_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def restart_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.restart_autonomous_database(autonomous_database_id, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_autonomous_database(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def restore_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, restore_autonomous_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) + Request to perform an Autonomous Database restore. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + operation_result = self.client.restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3250,32 +4414,30 @@ def reinstate_autonomous_container_database_dataguard_association_and_wait_for_w except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def reinstate_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def restore_autonomous_database_and_wait_for_state(self, autonomous_database_id, restore_autonomous_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) + Request to perform an Autonomous Database restore. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.reinstate_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + operation_result = self.client.restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -3285,7 +4447,7 @@ def reinstate_autonomous_container_database_dataguard_association_and_wait_for_s try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), + self.client.get_autonomous_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3295,9 +4457,9 @@ def reinstate_autonomous_container_database_dataguard_association_and_wait_for_s except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def reinstate_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def restore_database_and_wait_for_work_request(self, database_id, restore_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.restore_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str database_id: (required) @@ -3305,26 +4467,21 @@ def reinstate_data_guard_association_and_wait_for_work_request(self, database_id __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) - A request to reinstate a database in a standby role. + :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) + Request to perform database restore. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.reinstate_data_guard_association(database_id, data_guard_association_id, reinstate_data_guard_association_details, **operation_kwargs) + operation_result = self.client.restore_database(database_id, restore_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3340,9 +4497,9 @@ def reinstate_data_guard_association_and_wait_for_work_request(self, database_id except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def reinstate_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def restore_database_and_wait_for_state(self, database_id, restore_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.restore_database` and waits for the :py:class:`~oci.database.models.Database` acted upon to enter the given state(s). :param str database_id: (required) @@ -3350,25 +4507,20 @@ def reinstate_data_guard_association_and_wait_for_state(self, database_id, data_ __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.ReinstateDataGuardAssociationDetails reinstate_data_guard_association_details: (required) - A request to reinstate a database in a standby role. + :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) + Request to perform database restore. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reinstate_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.reinstate_data_guard_association(database_id, data_guard_association_id, reinstate_data_guard_association_details, **operation_kwargs) + operation_result = self.client.restore_database(database_id, restore_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -3378,7 +4530,7 @@ def reinstate_data_guard_association_and_wait_for_state(self, database_id, data_ try: waiter_result = oci.wait_until( self.client, - self.client.get_data_guard_association(wait_for_resource_id), + self.client.get_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3388,9 +4540,9 @@ def reinstate_data_guard_association_and_wait_for_state(self, database_id, data_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restart_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_autonomous_container_database_encryption_key_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_container_database_id: (required) @@ -3403,13 +4555,13 @@ def restart_autonomous_container_database_and_wait_for_work_request(self, autono Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restart_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) + operation_result = self.client.rotate_autonomous_container_database_encryption_key(autonomous_container_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3425,9 +4577,9 @@ def restart_autonomous_container_database_and_wait_for_work_request(self, autono except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restart_autonomous_container_database_and_wait_for_state(self, autonomous_container_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_autonomous_container_database_encryption_key_and_wait_for_state(self, autonomous_container_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon to enter the given state(s). :param str autonomous_container_database_id: (required) @@ -3439,13 +4591,13 @@ def restart_autonomous_container_database_and_wait_for_state(self, autonomous_co An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restart_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) + operation_result = self.client.rotate_autonomous_container_database_encryption_key(autonomous_container_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3465,9 +4617,9 @@ def restart_autonomous_container_database_and_wait_for_state(self, autonomous_co except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restart_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_autonomous_database_encryption_key_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_database_id: (required) @@ -3480,13 +4632,13 @@ def restart_autonomous_database_and_wait_for_work_request(self, autonomous_datab Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restart_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.rotate_autonomous_database_encryption_key(autonomous_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3502,9 +4654,9 @@ def restart_autonomous_database_and_wait_for_work_request(self, autonomous_datab except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restart_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_autonomous_database_encryption_key_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). :param str autonomous_database_id: (required) @@ -3516,13 +4668,13 @@ def restart_autonomous_database_and_wait_for_state(self, autonomous_database_id, An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restart_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restart_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.rotate_autonomous_database_encryption_key(autonomous_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3542,31 +4694,28 @@ def restart_autonomous_database_and_wait_for_state(self, autonomous_database_id, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restore_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, restore_autonomous_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_ords_certs_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.rotate_ords_certs` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) - Request to perform an Autonomous Database restore. - :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_ords_certs` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **operation_kwargs) + operation_result = self.client.rotate_ords_certs(autonomous_exadata_infrastructure_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3582,52 +4731,46 @@ def restore_autonomous_database_and_wait_for_work_request(self, autonomous_datab except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restore_autonomous_database_and_wait_for_state(self, autonomous_database_id, restore_autonomous_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_ssl_certs_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.rotate_ssl_certs` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) - Request to perform an Autonomous Database restore. - - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_ssl_certs` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restore_autonomous_database(autonomous_database_id, restore_autonomous_database_details, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.rotate_ssl_certs(autonomous_exadata_infrastructure_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_database(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restore_database_and_wait_for_work_request(self, database_id, restore_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_vault_key_and_wait_for_work_request(self, database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restore_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.rotate_vault_key` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str database_id: (required) @@ -3635,21 +4778,18 @@ def restore_database_and_wait_for_work_request(self, database_id, restore_databa __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) - Request to perform database restore. - :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_vault_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restore_database(database_id, restore_database_details, **operation_kwargs) + operation_result = self.client.rotate_vault_key(database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3665,9 +4805,9 @@ def restore_database_and_wait_for_work_request(self, database_id, restore_databa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def restore_database_and_wait_for_state(self, database_id, restore_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def rotate_vault_key_and_wait_for_state(self, database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.restore_database` and waits for the :py:class:`~oci.database.models.Database` acted upon + Calls :py:func:`~oci.database.DatabaseClient.rotate_vault_key` and waits for the :py:class:`~oci.database.models.Database` acted upon to enter the given state(s). :param str database_id: (required) @@ -3675,20 +4815,17 @@ def restore_database_and_wait_for_state(self, database_id, restore_database_deta __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.RestoreDatabaseDetails restore_database_details: (required) - Request to perform database restore. - :param list[str] wait_for_states: An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.restore_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_vault_key` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.restore_database(database_id, restore_database_details, **operation_kwargs) + operation_result = self.client.rotate_vault_key(database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3708,13 +4845,19 @@ def restore_database_and_wait_for_state(self, database_id, restore_database_deta except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_autonomous_container_database_encryption_key_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def scan_external_container_database_pluggable_databases_and_wait_for_work_request(self, external_container_database_id, external_database_connector_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.scan_external_container_database_pluggable_databases` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3723,13 +4866,13 @@ def rotate_autonomous_container_database_encryption_key_and_wait_for_work_reques Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.scan_external_container_database_pluggable_databases` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_autonomous_container_database_encryption_key(autonomous_container_database_id, **operation_kwargs) + operation_result = self.client.scan_external_container_database_pluggable_databases(external_container_database_id, external_database_connector_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3745,27 +4888,64 @@ def rotate_autonomous_container_database_encryption_key_and_wait_for_work_reques except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_autonomous_container_database_encryption_key_and_wait_for_state(self, autonomous_container_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def start_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.start_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.start_autonomous_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.start_autonomous_database(autonomous_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + **waiter_kwargs + ) + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def start_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.start_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + to enter the given state(s). + + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_container_database_encryption_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.start_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_autonomous_container_database_encryption_key(autonomous_container_database_id, **operation_kwargs) + operation_result = self.client.start_autonomous_database(autonomous_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3775,7 +4955,7 @@ def rotate_autonomous_container_database_encryption_key_and_wait_for_state(self, try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_container_database(wait_for_resource_id), + self.client.get_autonomous_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3785,9 +4965,9 @@ def rotate_autonomous_container_database_encryption_key_and_wait_for_state(self, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_autonomous_database_encryption_key_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def stop_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_database_id: (required) @@ -3800,13 +4980,13 @@ def rotate_autonomous_database_encryption_key_and_wait_for_work_request(self, au Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_autonomous_database_encryption_key(autonomous_database_id, **operation_kwargs) + operation_result = self.client.stop_autonomous_database(autonomous_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3822,9 +5002,9 @@ def rotate_autonomous_database_encryption_key_and_wait_for_work_request(self, au except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_autonomous_database_encryption_key_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def stop_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). :param str autonomous_database_id: (required) @@ -3836,13 +5016,13 @@ def rotate_autonomous_database_encryption_key_and_wait_for_state(self, autonomou An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_autonomous_database_encryption_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_autonomous_database_encryption_key(autonomous_database_id, **operation_kwargs) + operation_result = self.client.stop_autonomous_database(autonomous_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -3862,13 +5042,18 @@ def rotate_autonomous_database_encryption_key_and_wait_for_state(self, autonomou except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_ords_certs_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_ords_certs` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3877,13 +5062,13 @@ def rotate_ords_certs_and_wait_for_work_request(self, autonomous_exadata_infrast Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_ords_certs` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_ords_certs(autonomous_exadata_infrastructure_id, **operation_kwargs) + operation_result = self.client.switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3899,49 +5084,57 @@ def rotate_ords_certs_and_wait_for_work_request(self, autonomous_exadata_infrast except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_ssl_certs_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_ssl_certs` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon to enter the given state(s). - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param str autonomous_container_database_dataguard_association_id: (required) + The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_ssl_certs` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_ssl_certs(autonomous_exadata_infrastructure_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_vault_key_and_wait_for_work_request(self, database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_vault_key` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3951,13 +5144,13 @@ def rotate_vault_key_and_wait_for_work_request(self, database_id, work_request_s Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_vault_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_vault_key(database_id, **operation_kwargs) + operation_result = self.client.switchover_autonomous_database(autonomous_database_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -3973,27 +5166,27 @@ def rotate_vault_key_and_wait_for_work_request(self, database_id, work_request_s except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def rotate_vault_key_and_wait_for_state(self, database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.rotate_vault_key` and waits for the :py:class:`~oci.database.models.Database` acted upon + Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.rotate_vault_key` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.rotate_vault_key(database_id, **operation_kwargs) + operation_result = self.client.switchover_autonomous_database(autonomous_database_id, **operation_kwargs) if not wait_for_states: return operation_result @@ -4003,7 +5196,7 @@ def rotate_vault_key_and_wait_for_state(self, database_id, wait_for_states=[], o try: waiter_result = oci.wait_until( self.client, - self.client.get_database(wait_for_resource_id), + self.client.get_autonomous_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4013,28 +5206,36 @@ def rotate_vault_key_and_wait_for_state(self, database_id, wait_for_states=[], o except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def start_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, switchover_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.start_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) + :param str database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) + Request to swtichover a primary to a standby. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.start_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.start_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.switchover_data_guard_association(database_id, data_guard_association_id, switchover_data_guard_association_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4050,27 +5251,35 @@ def start_autonomous_database_and_wait_for_work_request(self, autonomous_databas except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def start_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def switchover_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, switchover_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.start_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon to enter the given state(s). - :param str autonomous_database_id: (required) + :param str database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) + Request to swtichover a primary to a standby. + :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.start_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.start_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.switchover_data_guard_association(database_id, data_guard_association_id, switchover_data_guard_association_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4079,24 +5288,61 @@ def start_autonomous_database_and_wait_for_state(self, autonomous_database_id, w try: waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_database(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self.client, + self.client.get_data_guard_association(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def terminate_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.terminate_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_autonomous_container_database` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.terminate_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def stop_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def terminate_autonomous_exadata_infrastructure_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.terminate_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -4105,13 +5351,13 @@ def stop_autonomous_database_and_wait_for_work_request(self, autonomous_database Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_autonomous_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.stop_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.terminate_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4127,49 +5373,46 @@ def stop_autonomous_database_and_wait_for_work_request(self, autonomous_database except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def stop_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def terminate_db_system_and_wait_for_work_request(self, db_system_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.terminate_db_system` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.stop_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_db_system` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.stop_autonomous_database(autonomous_database_id, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.terminate_db_system(db_system_id, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_database(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_autonomous_container_database_dataguard_association_and_wait_for_work_request(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, update_autonomous_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_container_database_id: (required) @@ -4177,23 +5420,21 @@ def switchover_autonomous_container_database_dataguard_association_and_wait_for_ __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) + Request to update the properties of an Autonomous Container Database. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + operation_result = self.client.update_autonomous_container_database(autonomous_container_database_id, update_autonomous_container_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4209,9 +5450,9 @@ def switchover_autonomous_container_database_dataguard_association_and_wait_for_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_autonomous_container_database_dataguard_association_and_wait_for_state(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_container_database_and_wait_for_state(self, autonomous_container_database_id, update_autonomous_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon to enter the given state(s). :param str autonomous_container_database_id: (required) @@ -4219,22 +5460,20 @@ def switchover_autonomous_container_database_dataguard_association_and_wait_for_ __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) + Request to update the properties of an Autonomous Container Database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabaseDataguardAssociation.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_container_database_dataguard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_autonomous_container_database_dataguard_association(autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **operation_kwargs) + operation_result = self.client.update_autonomous_container_database(autonomous_container_database_id, update_autonomous_container_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4244,7 +5483,7 @@ def switchover_autonomous_container_database_dataguard_association_and_wait_for_ try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_container_database_dataguard_association(wait_for_resource_id), + self.client.get_autonomous_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4254,9 +5493,9 @@ def switchover_autonomous_container_database_dataguard_association_and_wait_for_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, update_autonomous_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). :param str autonomous_database_id: (required) @@ -4264,18 +5503,21 @@ def switchover_autonomous_database_and_wait_for_work_request(self, autonomous_da __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) + Request to update the properties of an Autonomous Database. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.update_autonomous_database(autonomous_database_id, update_autonomous_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4291,9 +5533,9 @@ def switchover_autonomous_database_and_wait_for_work_request(self, autonomous_da except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_autonomous_database_and_wait_for_state(self, autonomous_database_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_database_and_wait_for_state(self, autonomous_database_id, update_autonomous_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon to enter the given state(s). :param str autonomous_database_id: (required) @@ -4301,17 +5543,20 @@ def switchover_autonomous_database_and_wait_for_state(self, autonomous_database_ __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) + Request to update the properties of an Autonomous Database. + :param list[str] wait_for_states: An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_autonomous_database(autonomous_database_id, **operation_kwargs) + operation_result = self.client.update_autonomous_database(autonomous_database_id, update_autonomous_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4331,36 +5576,26 @@ def switchover_autonomous_database_and_wait_for_state(self, autonomous_database_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_data_guard_association_and_wait_for_work_request(self, database_id, data_guard_association_id, switchover_data_guard_association_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_database_regional_wallet_and_wait_for_work_request(self, update_autonomous_database_wallet_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database_regional_wallet` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) - Request to swtichover a primary to a standby. + :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) + Request to update the properties of Autonomous Database regional wallet. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database_regional_wallet` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_data_guard_association(database_id, data_guard_association_id, switchover_data_guard_association_details, **operation_kwargs) + operation_result = self.client.update_autonomous_database_regional_wallet(update_autonomous_database_wallet_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4376,76 +5611,71 @@ def switchover_data_guard_association_and_wait_for_work_request(self, database_i except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def switchover_data_guard_association_and_wait_for_state(self, database_id, data_guard_association_id, switchover_data_guard_association_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_database_wallet_and_wait_for_work_request(self, autonomous_database_id, update_autonomous_database_wallet_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` and waits for the :py:class:`~oci.database.models.DataGuardAssociation` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database_wallet` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.SwitchoverDataGuardAssociationDetails switchover_data_guard_association_details: (required) - Request to swtichover a primary to a standby. + :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) + Request to update the properties of an Autonomous Database wallet. - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DataGuardAssociation.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.switchover_data_guard_association` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database_wallet` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.switchover_data_guard_association(database_id, data_guard_association_id, switchover_data_guard_association_details, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.update_autonomous_database_wallet(autonomous_database_id, update_autonomous_database_wallet_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_data_guard_association(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def terminate_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_exadata_infrastructure_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.terminate_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) + Request to update the properties of a Autonomous Exadata Infrastructure. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_autonomous_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.terminate_autonomous_container_database(autonomous_container_database_id, **operation_kwargs) + operation_result = self.client.update_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4461,9 +5691,9 @@ def terminate_autonomous_container_database_and_wait_for_work_request(self, auto except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def terminate_autonomous_exadata_infrastructure_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_exadata_infrastructure_and_wait_for_state(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.terminate_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.AutonomousExadataInfrastructure` acted upon to enter the given state(s). :param str autonomous_exadata_infrastructure_id: (required) @@ -4471,55 +5701,64 @@ def terminate_autonomous_exadata_infrastructure_and_wait_for_work_request(self, __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) + Request to update the properties of a Autonomous Exadata Infrastructure. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousExadataInfrastructure.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_autonomous_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.terminate_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.update_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_autonomous_exadata_infrastructure(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def terminate_db_system_and_wait_for_work_request(self, db_system_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.terminate_db_system` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) + Request to update the attributes of an Autonomous VM cluster. + :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.terminate_db_system` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.terminate_db_system(db_system_id, **operation_kwargs) + operation_result = self.client.update_autonomous_vm_cluster(autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4535,70 +5774,74 @@ def terminate_db_system_and_wait_for_work_request(self, db_system_id, work_reque except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_container_database_and_wait_for_work_request(self, autonomous_container_database_id, update_autonomous_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_autonomous_vm_cluster_and_wait_for_state(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` and waits for the :py:class:`~oci.database.models.AutonomousVmCluster` acted upon to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) - Request to update the properties of an Autonomous Container Database. + :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) + Request to update the attributes of an Autonomous VM cluster. - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousVmCluster.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_container_database(autonomous_container_database_id, update_autonomous_container_database_details, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.update_autonomous_vm_cluster(autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_autonomous_vm_cluster(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_container_database_and_wait_for_state(self, autonomous_container_database_id, update_autonomous_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_backup_destination_and_wait_for_state(self, backup_destination_id, update_backup_destination_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` and waits for the :py:class:`~oci.database.models.AutonomousContainerDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_backup_destination` and waits for the :py:class:`~oci.database.models.BackupDestination` acted upon to enter the given state(s). - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousContainerDatabaseDetails update_autonomous_container_database_details: (required) - Request to update the properties of an Autonomous Container Database. + :param oci.database.models.UpdateBackupDestinationDetails update_backup_destination_details: (required) + For a RECOVERY_APPLIANCE backup destination, request to update the connection string and/or the list of VPC users. + For an NFS backup destination, request to update the NFS location. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousContainerDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.BackupDestination.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_backup_destination` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_container_database(autonomous_container_database_id, update_autonomous_container_database_details, **operation_kwargs) + operation_result = self.client.update_backup_destination(backup_destination_id, update_backup_destination_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4608,7 +5851,7 @@ def update_autonomous_container_database_and_wait_for_state(self, autonomous_con try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_container_database(wait_for_resource_id), + self.client.get_backup_destination(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4618,31 +5861,31 @@ def update_autonomous_container_database_and_wait_for_state(self, autonomous_con except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_database_and_wait_for_work_request(self, autonomous_database_id, update_autonomous_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) - Request to update the properties of an Autonomous Database. + :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) + Request to update the properties of an cloud Exadata infrastructure resource. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_database(autonomous_database_id, update_autonomous_database_details, **operation_kwargs) + operation_result = self.client.update_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4658,30 +5901,30 @@ def update_autonomous_database_and_wait_for_work_request(self, autonomous_databa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_database_and_wait_for_state(self, autonomous_database_id, update_autonomous_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_cloud_exadata_infrastructure_and_wait_for_state(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database` and waits for the :py:class:`~oci.database.models.AutonomousDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.CloudExadataInfrastructure` acted upon to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseDetails update_autonomous_database_details: (required) - Request to update the properties of an Autonomous Database. + :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) + Request to update the properties of an cloud Exadata infrastructure resource. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.CloudExadataInfrastructure.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_database(autonomous_database_id, update_autonomous_database_details, **operation_kwargs) + operation_result = self.client.update_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4691,7 +5934,7 @@ def update_autonomous_database_and_wait_for_state(self, autonomous_database_id, try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_database(wait_for_resource_id), + self.client.get_cloud_exadata_infrastructure(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4701,26 +5944,31 @@ def update_autonomous_database_and_wait_for_state(self, autonomous_database_id, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_database_regional_wallet_and_wait_for_work_request(self, update_autonomous_database_wallet_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_cloud_vm_cluster_and_wait_for_work_request(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database_regional_wallet` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) - Request to update the properties of Autonomous Database regional wallet. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) + Request to update the attributes of a cloud VM cluster. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database_regional_wallet` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_database_regional_wallet(update_autonomous_database_wallet_details, **operation_kwargs) + operation_result = self.client.update_cloud_vm_cluster(cloud_vm_cluster_id, update_cloud_vm_cluster_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4736,71 +5984,74 @@ def update_autonomous_database_regional_wallet_and_wait_for_work_request(self, u except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_database_wallet_and_wait_for_work_request(self, autonomous_database_id, update_autonomous_database_wallet_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_cloud_vm_cluster_and_wait_for_state(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_database_wallet` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` and waits for the :py:class:`~oci.database.models.CloudVmCluster` acted upon to enter the given state(s). - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) - Request to update the properties of an Autonomous Database wallet. + :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) + Request to update the attributes of a cloud VM cluster. - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.CloudVmCluster.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_database_wallet` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_database_wallet(autonomous_database_id, update_autonomous_database_wallet_details, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.update_cloud_vm_cluster(cloud_vm_cluster_id, update_cloud_vm_cluster_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_cloud_vm_cluster(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_exadata_infrastructure_and_wait_for_work_request(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_cloud_vm_cluster_iorm_config_and_wait_for_work_request(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster_iorm_config` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) - Request to update the properties of a Autonomous Exadata Infrastructure. + :param oci.database.models.ExadataIormConfigUpdateDetails cloud_vm_cluster_iorm_config_update_details: (required) + Request to perform database update. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster_iorm_config` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **operation_kwargs) + operation_result = self.client.update_cloud_vm_cluster_iorm_config(cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4816,74 +6067,31 @@ def update_autonomous_exadata_infrastructure_and_wait_for_work_request(self, aut except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_exadata_infrastructure_and_wait_for_state(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): - """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.AutonomousExadataInfrastructure` acted upon - to enter the given state(s). - - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.UpdateAutonomousExadataInfrastructureDetails update_autonomous_exadata_infrastructures_details: (required) - Request to update the properties of a Autonomous Exadata Infrastructure. - - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousExadataInfrastructure.lifecycle_state` - - :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_exadata_infrastructure` - - :param dict waiter_kwargs: - A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` - as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait - """ - operation_result = self.client.update_autonomous_exadata_infrastructure(autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id - - try: - waiter_result = oci.wait_until( - self.client, - self.client.get_autonomous_exadata_infrastructure(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, - **waiter_kwargs - ) - result_to_return = waiter_result - - return result_to_return - except Exception as e: - raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - - def update_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_database_and_wait_for_work_request(self, database_id, update_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) - Request to update the attributes of an Autonomous VM cluster. + :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) + Request to perform database update. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_vm_cluster(autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_database(database_id, update_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -4899,30 +6107,30 @@ def update_autonomous_vm_cluster_and_wait_for_work_request(self, autonomous_vm_c except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_autonomous_vm_cluster_and_wait_for_state(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_database_and_wait_for_state(self, database_id, update_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` and waits for the :py:class:`~oci.database.models.AutonomousVmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_database` and waits for the :py:class:`~oci.database.models.Database` acted upon to enter the given state(s). - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + :param str database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousVmClusterDetails update_autonomous_vm_cluster_details: (required) - Request to update the attributes of an Autonomous VM cluster. + :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) + Request to perform database update. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.AutonomousVmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_autonomous_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_autonomous_vm_cluster(autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_database(database_id, update_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4932,7 +6140,7 @@ def update_autonomous_vm_cluster_and_wait_for_state(self, autonomous_vm_cluster_ try: waiter_result = oci.wait_until( self.client, - self.client.get_autonomous_vm_cluster(wait_for_resource_id), + self.client.get_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4942,31 +6150,30 @@ def update_autonomous_vm_cluster_and_wait_for_state(self, autonomous_vm_cluster_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_backup_destination_and_wait_for_state(self, backup_destination_id, update_backup_destination_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_database_software_image_and_wait_for_state(self, database_software_image_id, update_database_software_image_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_backup_destination` and waits for the :py:class:`~oci.database.models.BackupDestination` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_database_software_image` and waits for the :py:class:`~oci.database.models.DatabaseSoftwareImage` acted upon to enter the given state(s). - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param str database_software_image_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateBackupDestinationDetails update_backup_destination_details: (required) - For a RECOVERY_APPLIANCE backup destination, request to update the connection string and/or the list of VPC users. - For an NFS backup destination, request to update the NFS location. + :param oci.database.models.UpdateDatabaseSoftwareImageDetails update_database_software_image_details: (required) + Request to update the properties of a DB system. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.BackupDestination.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DatabaseSoftwareImage.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_backup_destination` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database_software_image` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_backup_destination(backup_destination_id, update_backup_destination_details, **operation_kwargs) + operation_result = self.client.update_database_software_image(database_software_image_id, update_database_software_image_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -4976,7 +6183,7 @@ def update_backup_destination_and_wait_for_state(self, backup_destination_id, up try: waiter_result = oci.wait_until( self.client, - self.client.get_backup_destination(wait_for_resource_id), + self.client.get_database_software_image(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4986,31 +6193,31 @@ def update_backup_destination_and_wait_for_state(self, backup_destination_id, up except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_db_home_and_wait_for_work_request(self, db_home_id, update_db_home_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_db_home` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) - Request to update the properties of an cloud Exadata infrastructure resource. + :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) + Request to update the properties of a Database Home. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_home` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.update_db_home(db_home_id, update_db_home_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5026,30 +6233,30 @@ def update_cloud_exadata_infrastructure_and_wait_for_work_request(self, cloud_ex except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_cloud_exadata_infrastructure_and_wait_for_state(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_db_home_and_wait_for_state(self, db_home_id, update_db_home_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.CloudExadataInfrastructure` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_db_home` and waits for the :py:class:`~oci.database.models.DbHome` acted upon to enter the given state(s). - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) - Request to update the properties of an cloud Exadata infrastructure resource. + :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) + Request to update the properties of a Database Home. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.CloudExadataInfrastructure.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbHome.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_home` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_cloud_exadata_infrastructure(cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.update_db_home(db_home_id, update_db_home_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5059,7 +6266,7 @@ def update_cloud_exadata_infrastructure_and_wait_for_state(self, cloud_exadata_i try: waiter_result = oci.wait_until( self.client, - self.client.get_cloud_exadata_infrastructure(wait_for_resource_id), + self.client.get_db_home(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5069,31 +6276,31 @@ def update_cloud_exadata_infrastructure_and_wait_for_state(self, cloud_exadata_i except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_cloud_vm_cluster_and_wait_for_work_request(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_db_system_and_wait_for_work_request(self, db_system_id, update_db_system_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_db_system` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) - Request to update the attributes of a cloud VM cluster. + :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) + Request to update the properties of a DB system. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_system` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_cloud_vm_cluster(cloud_vm_cluster_id, update_cloud_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_db_system(db_system_id, update_db_system_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5109,30 +6316,30 @@ def update_cloud_vm_cluster_and_wait_for_work_request(self, cloud_vm_cluster_id, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_cloud_vm_cluster_and_wait_for_state(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_db_system_and_wait_for_state(self, db_system_id, update_db_system_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` and waits for the :py:class:`~oci.database.models.CloudVmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_db_system` and waits for the :py:class:`~oci.database.models.DbSystem` acted upon to enter the given state(s). - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) - Request to update the attributes of a cloud VM cluster. + :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) + Request to update the properties of a DB system. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.CloudVmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbSystem.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_system` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_cloud_vm_cluster(cloud_vm_cluster_id, update_cloud_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_db_system(db_system_id, update_db_system_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5142,7 +6349,7 @@ def update_cloud_vm_cluster_and_wait_for_state(self, cloud_vm_cluster_id, update try: waiter_result = oci.wait_until( self.client, - self.client.get_cloud_vm_cluster(wait_for_resource_id), + self.client.get_db_system(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5152,31 +6359,31 @@ def update_cloud_vm_cluster_and_wait_for_state(self, cloud_vm_cluster_id, update except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_cloud_vm_cluster_iorm_config_and_wait_for_work_request(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_exadata_infrastructure_and_wait_for_work_request(self, exadata_infrastructure_id, update_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster_iorm_config` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ExadataIormConfigUpdateDetails cloud_vm_cluster_iorm_config_update_details: (required) - Request to perform database update. + :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) + Request to update the properties of an Exadata Cloud@Customer infrastructure. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_cloud_vm_cluster_iorm_config` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_cloud_vm_cluster_iorm_config(cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **operation_kwargs) + operation_result = self.client.update_exadata_infrastructure(exadata_infrastructure_id, update_exadata_infrastructure_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5192,113 +6399,113 @@ def update_cloud_vm_cluster_iorm_config_and_wait_for_work_request(self, cloud_vm except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_database_and_wait_for_work_request(self, database_id, update_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_exadata_infrastructure_and_wait_for_state(self, exadata_infrastructure_id, update_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.ExadataInfrastructure` acted upon to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) - Request to perform database update. + :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) + Request to update the properties of an Exadata Cloud@Customer infrastructure. - :param list[str] work_request_states: (optional) - An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` - Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExadataInfrastructure.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_database(database_id, update_database_details, **operation_kwargs) - work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES - lowered_work_request_states = [w.lower() for w in work_request_states] - work_request_id = operation_result.headers['opc-work-request-id'] + operation_result = self.client.update_exadata_infrastructure(exadata_infrastructure_id, update_exadata_infrastructure_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id try: waiter_result = oci.wait_until( - self._work_request_client, - self._work_request_client.get_work_request(work_request_id), - evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, + self.client, + self.client.get_exadata_infrastructure(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) - return waiter_result + result_to_return = waiter_result + + return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_database_and_wait_for_state(self, database_id, update_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_exadata_iorm_config_and_wait_for_work_request(self, db_system_id, exadata_iorm_config_update_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_database` and waits for the :py:class:`~oci.database.models.Database` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str database_id: (required) - The database `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDatabaseDetails update_database_details: (required) + :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) Request to perform database update. - :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.Database.lifecycle_state` + :param list[str] work_request_states: (optional) + An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` + Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_database(database_id, update_database_details, **operation_kwargs) - if not wait_for_states: - return operation_result - - lowered_wait_for_states = [w.lower() for w in wait_for_states] - wait_for_resource_id = operation_result.data.id + operation_result = self.client.update_exadata_iorm_config(db_system_id, exadata_iorm_config_update_details, **operation_kwargs) + work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES + lowered_work_request_states = [w.lower() for w in work_request_states] + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_database(wait_for_resource_id), - evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + self._work_request_client, + self._work_request_client.get_work_request(work_request_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - result_to_return = waiter_result - - return result_to_return + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_database_software_image_and_wait_for_state(self, database_software_image_id, update_database_software_image_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_exadata_iorm_config_and_wait_for_state(self, db_system_id, exadata_iorm_config_update_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_database_software_image` and waits for the :py:class:`~oci.database.models.DatabaseSoftwareImage` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` and waits for the :py:class:`~oci.database.models.ExadataIormConfig` acted upon to enter the given state(s). - :param str database_software_image_id: (required) + :param str db_system_id: (required) The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDatabaseSoftwareImageDetails update_database_software_image_details: (required) - Request to update the properties of a DB system. + :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) + Request to perform database update. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DatabaseSoftwareImage.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExadataIormConfig.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_database_software_image` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_database_software_image(database_software_image_id, update_database_software_image_details, **operation_kwargs) + operation_result = self.client.update_exadata_iorm_config(db_system_id, exadata_iorm_config_update_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5308,7 +6515,7 @@ def update_database_software_image_and_wait_for_state(self, database_software_im try: waiter_result = oci.wait_until( self.client, - self.client.get_database_software_image(wait_for_resource_id), + self.client.get_exadata_iorm_config(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5318,31 +6525,32 @@ def update_database_software_image_and_wait_for_state(self, database_software_im except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_db_home_and_wait_for_work_request(self, db_home_id, update_db_home_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_container_database_and_wait_for_work_request(self, external_container_database_id, update_external_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_db_home` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_external_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) - Request to update the properties of a Database Home. + :param oci.database.models.UpdateExternalContainerDatabaseDetails update_external_container_database_details: (required) + Request to update the properties of an + :func:`create_external_container_database_details` resource. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_home` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_db_home(db_home_id, update_db_home_details, **operation_kwargs) + operation_result = self.client.update_external_container_database(external_container_database_id, update_external_container_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5358,30 +6566,31 @@ def update_db_home_and_wait_for_work_request(self, db_home_id, update_db_home_de except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_db_home_and_wait_for_state(self, db_home_id, update_db_home_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_container_database_and_wait_for_state(self, external_container_database_id, update_external_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_db_home` and waits for the :py:class:`~oci.database.models.DbHome` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_external_container_database` and waits for the :py:class:`~oci.database.models.ExternalContainerDatabase` acted upon to enter the given state(s). - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbHomeDetails update_db_home_details: (required) - Request to update the properties of a Database Home. + :param oci.database.models.UpdateExternalContainerDatabaseDetails update_external_container_database_details: (required) + Request to update the properties of an + :func:`create_external_container_database_details` resource. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbHome.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_home` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_db_home(db_home_id, update_db_home_details, **operation_kwargs) + operation_result = self.client.update_external_container_database(external_container_database_id, update_external_container_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5391,7 +6600,7 @@ def update_db_home_and_wait_for_state(self, db_home_id, update_db_home_details, try: waiter_result = oci.wait_until( self.client, - self.client.get_db_home(wait_for_resource_id), + self.client.get_external_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5401,31 +6610,32 @@ def update_db_home_and_wait_for_state(self, db_home_id, update_db_home_details, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_db_system_and_wait_for_work_request(self, db_system_id, update_db_system_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_database_connector_and_wait_for_work_request(self, external_database_connector_id, update_external_database_connector_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_db_system` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_external_database_connector` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) - Request to update the properties of a DB system. + :param oci.database.models.UpdateExternalDatabaseConnectorDetails update_external_database_connector_details: (required) + Request to update the properties of an external database connector. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_system` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_database_connector` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_db_system(db_system_id, update_db_system_details, **operation_kwargs) + operation_result = self.client.update_external_database_connector(external_database_connector_id, update_external_database_connector_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5441,30 +6651,31 @@ def update_db_system_and_wait_for_work_request(self, db_system_id, update_db_sys except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_db_system_and_wait_for_state(self, db_system_id, update_db_system_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_database_connector_and_wait_for_state(self, external_database_connector_id, update_external_database_connector_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_db_system` and waits for the :py:class:`~oci.database.models.DbSystem` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_external_database_connector` and waits for the :py:class:`~oci.database.models.ExternalDatabaseConnector` acted upon to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbSystemDetails update_db_system_details: (required) - Request to update the properties of a DB system. + :param oci.database.models.UpdateExternalDatabaseConnectorDetails update_external_database_connector_details: (required) + Request to update the properties of an external database connector. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.DbSystem.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalDatabaseConnector.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_db_system` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_database_connector` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_db_system(db_system_id, update_db_system_details, **operation_kwargs) + operation_result = self.client.update_external_database_connector(external_database_connector_id, update_external_database_connector_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5474,7 +6685,7 @@ def update_db_system_and_wait_for_state(self, db_system_id, update_db_system_det try: waiter_result = oci.wait_until( self.client, - self.client.get_db_system(wait_for_resource_id), + self.client.get_external_database_connector(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5484,31 +6695,31 @@ def update_db_system_and_wait_for_state(self, db_system_id, update_db_system_det except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadata_infrastructure_and_wait_for_work_request(self, exadata_infrastructure_id, update_exadata_infrastructure_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_non_container_database_and_wait_for_work_request(self, external_non_container_database_id, update_external_non_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_external_non_container_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) - Request to update the properties of an Exadata Cloud@Customer infrastructure. + :param oci.database.models.UpdateExternalNonContainerDatabaseDetails update_external_non_container_database_details: (required) + Request to update the properties of an external non-container database. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_non_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_exadata_infrastructure(exadata_infrastructure_id, update_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.update_external_non_container_database(external_non_container_database_id, update_external_non_container_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5524,30 +6735,30 @@ def update_exadata_infrastructure_and_wait_for_work_request(self, exadata_infras except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadata_infrastructure_and_wait_for_state(self, exadata_infrastructure_id, update_exadata_infrastructure_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_non_container_database_and_wait_for_state(self, external_non_container_database_id, update_external_non_container_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` and waits for the :py:class:`~oci.database.models.ExadataInfrastructure` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_external_non_container_database` and waits for the :py:class:`~oci.database.models.ExternalNonContainerDatabase` acted upon to enter the given state(s). - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str external_non_container_database_id: (required) + The external non-container database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExadataInfrastructureDetails update_exadata_infrastructure_details: (required) - Request to update the properties of an Exadata Cloud@Customer infrastructure. + :param oci.database.models.UpdateExternalNonContainerDatabaseDetails update_external_non_container_database_details: (required) + Request to update the properties of an external non-container database. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExadataInfrastructure.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalNonContainerDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_infrastructure` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_non_container_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_exadata_infrastructure(exadata_infrastructure_id, update_exadata_infrastructure_details, **operation_kwargs) + operation_result = self.client.update_external_non_container_database(external_non_container_database_id, update_external_non_container_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5557,7 +6768,7 @@ def update_exadata_infrastructure_and_wait_for_state(self, exadata_infrastructur try: waiter_result = oci.wait_until( self.client, - self.client.get_exadata_infrastructure(wait_for_resource_id), + self.client.get_external_non_container_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5567,31 +6778,31 @@ def update_exadata_infrastructure_and_wait_for_state(self, exadata_infrastructur except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadata_iorm_config_and_wait_for_work_request(self, db_system_id, exadata_iorm_config_update_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_pluggable_database_and_wait_for_work_request(self, external_pluggable_database_id, update_external_pluggable_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_external_pluggable_database` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) - Request to perform database update. + :param oci.database.models.UpdateExternalPluggableDatabaseDetails update_external_pluggable_database_details: (required) + Request to update the properties of an external pluggable database resource. :param list[str] work_request_states: (optional) An array of work requests states to wait on. These should be valid values for :py:attr:`~oci.work_requests.models.WorkRequest.status` Default values are termination states: [STATUS_SUCCEEDED, STATUS_FAILED, STATUS_CANCELED] :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_pluggable_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_exadata_iorm_config(db_system_id, exadata_iorm_config_update_details, **operation_kwargs) + operation_result = self.client.update_external_pluggable_database(external_pluggable_database_id, update_external_pluggable_database_details, **operation_kwargs) work_request_states = work_request_states if work_request_states else oci.waiter._WORK_REQUEST_TERMINATION_STATES lowered_work_request_states = [w.lower() for w in work_request_states] work_request_id = operation_result.headers['opc-work-request-id'] @@ -5607,30 +6818,30 @@ def update_exadata_iorm_config_and_wait_for_work_request(self, db_system_id, exa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadata_iorm_config_and_wait_for_state(self, db_system_id, exadata_iorm_config_update_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_external_pluggable_database_and_wait_for_state(self, external_pluggable_database_id, update_external_pluggable_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` and waits for the :py:class:`~oci.database.models.ExadataIormConfig` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_external_pluggable_database` and waits for the :py:class:`~oci.database.models.ExternalPluggableDatabase` acted upon to enter the given state(s). - :param str db_system_id: (required) - The DB system `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) - Request to perform database update. + :param oci.database.models.UpdateExternalPluggableDatabaseDetails update_external_pluggable_database_details: (required) + Request to update the properties of an external pluggable database resource. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExadataIormConfig.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalPluggableDatabase.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadata_iorm_config` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_external_pluggable_database` :param dict waiter_kwargs: A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait """ - operation_result = self.client.update_exadata_iorm_config(db_system_id, exadata_iorm_config_update_details, **operation_kwargs) + operation_result = self.client.update_external_pluggable_database(external_pluggable_database_id, update_external_pluggable_database_details, **operation_kwargs) if not wait_for_states: return operation_result @@ -5640,7 +6851,7 @@ def update_exadata_iorm_config_and_wait_for_state(self, db_system_id, exadata_io try: waiter_result = oci.wait_until( self.client, - self.client.get_exadata_iorm_config(wait_for_resource_id), + self.client.get_external_pluggable_database(wait_for_resource_id), evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) diff --git a/src/oci/database/models/__init__.py b/src/oci/database/models/__init__.py index 65e05be487..dd0cc95dfa 100644 --- a/src/oci/database/models/__init__.py +++ b/src/oci/database/models/__init__.py @@ -91,6 +91,12 @@ from .create_db_home_with_vm_cluster_id_from_backup_details import CreateDbHomeWithVmClusterIdFromBackupDetails from .create_exadata_infrastructure_details import CreateExadataInfrastructureDetails from .create_external_backup_job_details import CreateExternalBackupJobDetails +from .create_external_container_database_details import CreateExternalContainerDatabaseDetails +from .create_external_database_connector_details import CreateExternalDatabaseConnectorDetails +from .create_external_database_details_base import CreateExternalDatabaseDetailsBase +from .create_external_macs_connector_details import CreateExternalMacsConnectorDetails +from .create_external_non_container_database_details import CreateExternalNonContainerDatabaseDetails +from .create_external_pluggable_database_details import CreateExternalPluggableDatabaseDetails from .create_key_store_details import CreateKeyStoreDetails from .create_nfs_backup_destination_details import CreateNFSBackupDestinationDetails from .create_new_database_details import CreateNewDatabaseDetails @@ -100,7 +106,12 @@ from .data_guard_association import DataGuardAssociation from .data_guard_association_summary import DataGuardAssociationSummary from .database import Database +from .database_connection_credentails_by_name import DatabaseConnectionCredentailsByName +from .database_connection_credentials import DatabaseConnectionCredentials +from .database_connection_credentials_by_details import DatabaseConnectionCredentialsByDetails +from .database_connection_string import DatabaseConnectionString from .database_connection_strings import DatabaseConnectionStrings +from .database_management_config import DatabaseManagementConfig from .database_software_image import DatabaseSoftwareImage from .database_software_image_summary import DatabaseSoftwareImageSummary from .database_summary import DatabaseSummary @@ -124,6 +135,10 @@ from .db_system_summary import DbSystemSummary from .db_version_summary import DbVersionSummary from .deregister_autonomous_database_data_safe_details import DeregisterAutonomousDatabaseDataSafeDetails +from .enable_external_container_database_database_management_details import EnableExternalContainerDatabaseDatabaseManagementDetails +from .enable_external_database_management_details_base import EnableExternalDatabaseManagementDetailsBase +from .enable_external_non_container_database_database_management_details import EnableExternalNonContainerDatabaseDatabaseManagementDetails +from .enable_external_pluggable_database_database_management_details import EnableExternalPluggableDatabaseDatabaseManagementDetails from .exadata_db_system_migration import ExadataDbSystemMigration from .exadata_db_system_migration_summary import ExadataDbSystemMigrationSummary from .exadata_infrastructure import ExadataInfrastructure @@ -132,6 +147,17 @@ from .exadata_iorm_config import ExadataIormConfig from .exadata_iorm_config_update_details import ExadataIormConfigUpdateDetails from .external_backup_job import ExternalBackupJob +from .external_container_database import ExternalContainerDatabase +from .external_container_database_summary import ExternalContainerDatabaseSummary +from .external_database_base import ExternalDatabaseBase +from .external_database_connector import ExternalDatabaseConnector +from .external_database_connector_summary import ExternalDatabaseConnectorSummary +from .external_macs_connector import ExternalMacsConnector +from .external_macs_connector_summary import ExternalMacsConnectorSummary +from .external_non_container_database import ExternalNonContainerDatabase +from .external_non_container_database_summary import ExternalNonContainerDatabaseSummary +from .external_pluggable_database import ExternalPluggableDatabase +from .external_pluggable_database_summary import ExternalPluggableDatabaseSummary from .failover_data_guard_association_details import FailoverDataGuardAssociationDetails from .flex_component_collection import FlexComponentCollection from .flex_component_summary import FlexComponentSummary @@ -186,6 +212,12 @@ from .update_db_system_details import UpdateDbSystemDetails from .update_details import UpdateDetails from .update_exadata_infrastructure_details import UpdateExadataInfrastructureDetails +from .update_external_container_database_details import UpdateExternalContainerDatabaseDetails +from .update_external_database_connector_details import UpdateExternalDatabaseConnectorDetails +from .update_external_database_details_base import UpdateExternalDatabaseDetailsBase +from .update_external_macs_connector_details import UpdateExternalMacsConnectorDetails +from .update_external_non_container_database_details import UpdateExternalNonContainerDatabaseDetails +from .update_external_pluggable_database_details import UpdateExternalPluggableDatabaseDetails from .update_history_entry import UpdateHistoryEntry from .update_history_entry_summary import UpdateHistoryEntrySummary from .update_key_store_details import UpdateKeyStoreDetails @@ -291,6 +323,12 @@ "CreateDbHomeWithVmClusterIdFromBackupDetails": CreateDbHomeWithVmClusterIdFromBackupDetails, "CreateExadataInfrastructureDetails": CreateExadataInfrastructureDetails, "CreateExternalBackupJobDetails": CreateExternalBackupJobDetails, + "CreateExternalContainerDatabaseDetails": CreateExternalContainerDatabaseDetails, + "CreateExternalDatabaseConnectorDetails": CreateExternalDatabaseConnectorDetails, + "CreateExternalDatabaseDetailsBase": CreateExternalDatabaseDetailsBase, + "CreateExternalMacsConnectorDetails": CreateExternalMacsConnectorDetails, + "CreateExternalNonContainerDatabaseDetails": CreateExternalNonContainerDatabaseDetails, + "CreateExternalPluggableDatabaseDetails": CreateExternalPluggableDatabaseDetails, "CreateKeyStoreDetails": CreateKeyStoreDetails, "CreateNFSBackupDestinationDetails": CreateNFSBackupDestinationDetails, "CreateNewDatabaseDetails": CreateNewDatabaseDetails, @@ -300,7 +338,12 @@ "DataGuardAssociation": DataGuardAssociation, "DataGuardAssociationSummary": DataGuardAssociationSummary, "Database": Database, + "DatabaseConnectionCredentailsByName": DatabaseConnectionCredentailsByName, + "DatabaseConnectionCredentials": DatabaseConnectionCredentials, + "DatabaseConnectionCredentialsByDetails": DatabaseConnectionCredentialsByDetails, + "DatabaseConnectionString": DatabaseConnectionString, "DatabaseConnectionStrings": DatabaseConnectionStrings, + "DatabaseManagementConfig": DatabaseManagementConfig, "DatabaseSoftwareImage": DatabaseSoftwareImage, "DatabaseSoftwareImageSummary": DatabaseSoftwareImageSummary, "DatabaseSummary": DatabaseSummary, @@ -324,6 +367,10 @@ "DbSystemSummary": DbSystemSummary, "DbVersionSummary": DbVersionSummary, "DeregisterAutonomousDatabaseDataSafeDetails": DeregisterAutonomousDatabaseDataSafeDetails, + "EnableExternalContainerDatabaseDatabaseManagementDetails": EnableExternalContainerDatabaseDatabaseManagementDetails, + "EnableExternalDatabaseManagementDetailsBase": EnableExternalDatabaseManagementDetailsBase, + "EnableExternalNonContainerDatabaseDatabaseManagementDetails": EnableExternalNonContainerDatabaseDatabaseManagementDetails, + "EnableExternalPluggableDatabaseDatabaseManagementDetails": EnableExternalPluggableDatabaseDatabaseManagementDetails, "ExadataDbSystemMigration": ExadataDbSystemMigration, "ExadataDbSystemMigrationSummary": ExadataDbSystemMigrationSummary, "ExadataInfrastructure": ExadataInfrastructure, @@ -332,6 +379,17 @@ "ExadataIormConfig": ExadataIormConfig, "ExadataIormConfigUpdateDetails": ExadataIormConfigUpdateDetails, "ExternalBackupJob": ExternalBackupJob, + "ExternalContainerDatabase": ExternalContainerDatabase, + "ExternalContainerDatabaseSummary": ExternalContainerDatabaseSummary, + "ExternalDatabaseBase": ExternalDatabaseBase, + "ExternalDatabaseConnector": ExternalDatabaseConnector, + "ExternalDatabaseConnectorSummary": ExternalDatabaseConnectorSummary, + "ExternalMacsConnector": ExternalMacsConnector, + "ExternalMacsConnectorSummary": ExternalMacsConnectorSummary, + "ExternalNonContainerDatabase": ExternalNonContainerDatabase, + "ExternalNonContainerDatabaseSummary": ExternalNonContainerDatabaseSummary, + "ExternalPluggableDatabase": ExternalPluggableDatabase, + "ExternalPluggableDatabaseSummary": ExternalPluggableDatabaseSummary, "FailoverDataGuardAssociationDetails": FailoverDataGuardAssociationDetails, "FlexComponentCollection": FlexComponentCollection, "FlexComponentSummary": FlexComponentSummary, @@ -386,6 +444,12 @@ "UpdateDbSystemDetails": UpdateDbSystemDetails, "UpdateDetails": UpdateDetails, "UpdateExadataInfrastructureDetails": UpdateExadataInfrastructureDetails, + "UpdateExternalContainerDatabaseDetails": UpdateExternalContainerDatabaseDetails, + "UpdateExternalDatabaseConnectorDetails": UpdateExternalDatabaseConnectorDetails, + "UpdateExternalDatabaseDetailsBase": UpdateExternalDatabaseDetailsBase, + "UpdateExternalMacsConnectorDetails": UpdateExternalMacsConnectorDetails, + "UpdateExternalNonContainerDatabaseDetails": UpdateExternalNonContainerDatabaseDetails, + "UpdateExternalPluggableDatabaseDetails": UpdateExternalPluggableDatabaseDetails, "UpdateHistoryEntry": UpdateHistoryEntry, "UpdateHistoryEntrySummary": UpdateHistoryEntrySummary, "UpdateKeyStoreDetails": UpdateKeyStoreDetails, diff --git a/src/oci/database/models/create_database_software_image_details.py b/src/oci/database/models/create_database_software_image_details.py index 478cee9a56..90c45831be 100644 --- a/src/oci/database/models/create_database_software_image_details.py +++ b/src/oci/database/models/create_database_software_image_details.py @@ -228,7 +228,7 @@ def image_shape_family(self, image_shape_family): def image_type(self): """ Gets the image_type of this CreateDatabaseSoftwareImageDetails. - List of the Fault Domains in which this DB system is provisioned. + The type of software image. Can be grid or database. Allowed values for this property are: "GRID_IMAGE", "DATABASE_IMAGE" @@ -242,7 +242,7 @@ def image_type(self): def image_type(self, image_type): """ Sets the image_type of this CreateDatabaseSoftwareImageDetails. - List of the Fault Domains in which this DB system is provisioned. + The type of software image. Can be grid or database. :param image_type: The image_type of this CreateDatabaseSoftwareImageDetails. diff --git a/src/oci/database/models/create_external_container_database_details.py b/src/oci/database/models/create_external_container_database_details.py new file mode 100644 index 0000000000..6f58801c9a --- /dev/null +++ b/src/oci/database/models/create_external_container_database_details.py @@ -0,0 +1,183 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalContainerDatabaseDetails(object): + """ + Details for creating an external container database resource. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalContainerDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this CreateExternalContainerDatabaseDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateExternalContainerDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalContainerDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalContainerDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateExternalContainerDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExternalContainerDatabaseDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExternalContainerDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExternalContainerDatabaseDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateExternalContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this CreateExternalContainerDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateExternalContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this CreateExternalContainerDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExternalContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateExternalContainerDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExternalContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateExternalContainerDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExternalContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateExternalContainerDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateExternalContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateExternalContainerDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/create_external_database_connector_details.py b/src/oci/database/models/create_external_database_connector_details.py new file mode 100644 index 0000000000..d34a30a0b0 --- /dev/null +++ b/src/oci/database/models/create_external_database_connector_details.py @@ -0,0 +1,248 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalDatabaseConnectorDetails(object): + """ + Details for creating an external database connector resource. + """ + + #: A constant which can be used with the connector_type property of a CreateExternalDatabaseConnectorDetails. + #: This constant has a value of "MACS" + CONNECTOR_TYPE_MACS = "MACS" + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalDatabaseConnectorDetails object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.database.models.CreateExternalMacsConnectorDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalDatabaseConnectorDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalDatabaseConnectorDetails. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this CreateExternalDatabaseConnectorDetails. + :type display_name: str + + :param connector_type: + The value to assign to the connector_type property of this CreateExternalDatabaseConnectorDetails. + Allowed values for this property are: "MACS" + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this CreateExternalDatabaseConnectorDetails. + :type external_database_id: str + + """ + self.swagger_types = { + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'connector_type': 'str', + 'external_database_id': 'str' + } + + self.attribute_map = { + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId' + } + + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._connector_type = None + self._external_database_id = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['connectorType'] + + if type == 'MACS': + return 'CreateExternalMacsConnectorDetails' + else: + return 'CreateExternalDatabaseConnectorDetails' + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExternalDatabaseConnectorDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateExternalDatabaseConnectorDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExternalDatabaseConnectorDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateExternalDatabaseConnectorDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExternalDatabaseConnectorDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateExternalDatabaseConnectorDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateExternalDatabaseConnectorDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateExternalDatabaseConnectorDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateExternalDatabaseConnectorDetails. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :return: The display_name of this CreateExternalDatabaseConnectorDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateExternalDatabaseConnectorDetails. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :param display_name: The display_name of this CreateExternalDatabaseConnectorDetails. + :type: str + """ + self._display_name = display_name + + @property + def connector_type(self): + """ + Gets the connector_type of this CreateExternalDatabaseConnectorDetails. + The type of connector used by the external database resource. + + Allowed values for this property are: "MACS" + + + :return: The connector_type of this CreateExternalDatabaseConnectorDetails. + :rtype: str + """ + return self._connector_type + + @connector_type.setter + def connector_type(self, connector_type): + """ + Sets the connector_type of this CreateExternalDatabaseConnectorDetails. + The type of connector used by the external database resource. + + + :param connector_type: The connector_type of this CreateExternalDatabaseConnectorDetails. + :type: str + """ + allowed_values = ["MACS"] + if not value_allowed_none_or_none_sentinel(connector_type, allowed_values): + raise ValueError( + "Invalid value for `connector_type`, must be None or one of {0}" + .format(allowed_values) + ) + self._connector_type = connector_type + + @property + def external_database_id(self): + """ + **[Required]** Gets the external_database_id of this CreateExternalDatabaseConnectorDetails. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_id of this CreateExternalDatabaseConnectorDetails. + :rtype: str + """ + return self._external_database_id + + @external_database_id.setter + def external_database_id(self, external_database_id): + """ + Sets the external_database_id of this CreateExternalDatabaseConnectorDetails. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_id: The external_database_id of this CreateExternalDatabaseConnectorDetails. + :type: str + """ + self._external_database_id = external_database_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/create_external_database_details_base.py b/src/oci/database/models/create_external_database_details_base.py new file mode 100644 index 0000000000..b483def937 --- /dev/null +++ b/src/oci/database/models/create_external_database_details_base.py @@ -0,0 +1,183 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalDatabaseDetailsBase(object): + """ + Details for creating an external database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalDatabaseDetailsBase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this CreateExternalDatabaseDetailsBase. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateExternalDatabaseDetailsBase. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalDatabaseDetailsBase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalDatabaseDetailsBase. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateExternalDatabaseDetailsBase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExternalDatabaseDetailsBase. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExternalDatabaseDetailsBase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExternalDatabaseDetailsBase. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateExternalDatabaseDetailsBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this CreateExternalDatabaseDetailsBase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateExternalDatabaseDetailsBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this CreateExternalDatabaseDetailsBase. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExternalDatabaseDetailsBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateExternalDatabaseDetailsBase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExternalDatabaseDetailsBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateExternalDatabaseDetailsBase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExternalDatabaseDetailsBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateExternalDatabaseDetailsBase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateExternalDatabaseDetailsBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateExternalDatabaseDetailsBase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/create_external_macs_connector_details.py b/src/oci/database/models/create_external_macs_connector_details.py new file mode 100644 index 0000000000..98f94f8d66 --- /dev/null +++ b/src/oci/database/models/create_external_macs_connector_details.py @@ -0,0 +1,167 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .create_external_database_connector_details import CreateExternalDatabaseConnectorDetails +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalMacsConnectorDetails(CreateExternalDatabaseConnectorDetails): + """ + Details for creating a resource used to connect to an external Oracle Database using + the `Management Agent cloud service (MACS)`__. + + __ https://docs.cloud.oracle.com/iaas/management-agents/index.html + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalMacsConnectorDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.CreateExternalMacsConnectorDetails.connector_type` attribute + of this class is ``MACS`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalMacsConnectorDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalMacsConnectorDetails. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this CreateExternalMacsConnectorDetails. + :type display_name: str + + :param connector_type: + The value to assign to the connector_type property of this CreateExternalMacsConnectorDetails. + Allowed values for this property are: "MACS" + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this CreateExternalMacsConnectorDetails. + :type external_database_id: str + + :param connection_string: + The value to assign to the connection_string property of this CreateExternalMacsConnectorDetails. + :type connection_string: oci.database.models.DatabaseConnectionString + + :param connection_credentials: + The value to assign to the connection_credentials property of this CreateExternalMacsConnectorDetails. + :type connection_credentials: oci.database.models.DatabaseConnectionCredentials + + :param connector_agent_id: + The value to assign to the connector_agent_id property of this CreateExternalMacsConnectorDetails. + :type connector_agent_id: str + + """ + self.swagger_types = { + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'connector_type': 'str', + 'external_database_id': 'str', + 'connection_string': 'DatabaseConnectionString', + 'connection_credentials': 'DatabaseConnectionCredentials', + 'connector_agent_id': 'str' + } + + self.attribute_map = { + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId', + 'connection_string': 'connectionString', + 'connection_credentials': 'connectionCredentials', + 'connector_agent_id': 'connectorAgentId' + } + + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._connector_type = None + self._external_database_id = None + self._connection_string = None + self._connection_credentials = None + self._connector_agent_id = None + self._connector_type = 'MACS' + + @property + def connection_string(self): + """ + **[Required]** Gets the connection_string of this CreateExternalMacsConnectorDetails. + + :return: The connection_string of this CreateExternalMacsConnectorDetails. + :rtype: oci.database.models.DatabaseConnectionString + """ + return self._connection_string + + @connection_string.setter + def connection_string(self, connection_string): + """ + Sets the connection_string of this CreateExternalMacsConnectorDetails. + + :param connection_string: The connection_string of this CreateExternalMacsConnectorDetails. + :type: oci.database.models.DatabaseConnectionString + """ + self._connection_string = connection_string + + @property + def connection_credentials(self): + """ + **[Required]** Gets the connection_credentials of this CreateExternalMacsConnectorDetails. + + :return: The connection_credentials of this CreateExternalMacsConnectorDetails. + :rtype: oci.database.models.DatabaseConnectionCredentials + """ + return self._connection_credentials + + @connection_credentials.setter + def connection_credentials(self, connection_credentials): + """ + Sets the connection_credentials of this CreateExternalMacsConnectorDetails. + + :param connection_credentials: The connection_credentials of this CreateExternalMacsConnectorDetails. + :type: oci.database.models.DatabaseConnectionCredentials + """ + self._connection_credentials = connection_credentials + + @property + def connector_agent_id(self): + """ + **[Required]** Gets the connector_agent_id of this CreateExternalMacsConnectorDetails. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :return: The connector_agent_id of this CreateExternalMacsConnectorDetails. + :rtype: str + """ + return self._connector_agent_id + + @connector_agent_id.setter + def connector_agent_id(self, connector_agent_id): + """ + Sets the connector_agent_id of this CreateExternalMacsConnectorDetails. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :param connector_agent_id: The connector_agent_id of this CreateExternalMacsConnectorDetails. + :type: str + """ + self._connector_agent_id = connector_agent_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/create_external_non_container_database_details.py b/src/oci/database/models/create_external_non_container_database_details.py new file mode 100644 index 0000000000..c631f50518 --- /dev/null +++ b/src/oci/database/models/create_external_non_container_database_details.py @@ -0,0 +1,183 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalNonContainerDatabaseDetails(object): + """ + Details for creating an external non-container database resource. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalNonContainerDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this CreateExternalNonContainerDatabaseDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateExternalNonContainerDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalNonContainerDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalNonContainerDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateExternalNonContainerDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExternalNonContainerDatabaseDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExternalNonContainerDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExternalNonContainerDatabaseDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateExternalNonContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this CreateExternalNonContainerDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateExternalNonContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this CreateExternalNonContainerDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExternalNonContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateExternalNonContainerDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExternalNonContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateExternalNonContainerDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExternalNonContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateExternalNonContainerDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateExternalNonContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateExternalNonContainerDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/create_external_pluggable_database_details.py b/src/oci/database/models/create_external_pluggable_database_details.py new file mode 100644 index 0000000000..c91d718b94 --- /dev/null +++ b/src/oci/database/models/create_external_pluggable_database_details.py @@ -0,0 +1,259 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateExternalPluggableDatabaseDetails(object): + """ + Details for creating an external pluggable database resource. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExternalPluggableDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param source_id: + The value to assign to the source_id property of this CreateExternalPluggableDatabaseDetails. + :type source_id: str + + :param external_container_database_id: + The value to assign to the external_container_database_id property of this CreateExternalPluggableDatabaseDetails. + :type external_container_database_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this CreateExternalPluggableDatabaseDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateExternalPluggableDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExternalPluggableDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExternalPluggableDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'source_id': 'str', + 'external_container_database_id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'source_id': 'sourceId', + 'external_container_database_id': 'externalContainerDatabaseId', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._source_id = None + self._external_container_database_id = None + self._compartment_id = None + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def source_id(self): + """ + Gets the source_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The source_id of this CreateExternalPluggableDatabaseDetails. + :rtype: str + """ + return self._source_id + + @source_id.setter + def source_id(self, source_id): + """ + Sets the source_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param source_id: The source_id of this CreateExternalPluggableDatabaseDetails. + :type: str + """ + self._source_id = source_id + + @property + def external_container_database_id(self): + """ + **[Required]** Gets the external_container_database_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The external_container_database_id of this CreateExternalPluggableDatabaseDetails. + :rtype: str + """ + return self._external_container_database_id + + @external_container_database_id.setter + def external_container_database_id(self, external_container_database_id): + """ + Sets the external_container_database_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param external_container_database_id: The external_container_database_id of this CreateExternalPluggableDatabaseDetails. + :type: str + """ + self._external_container_database_id = external_container_database_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExternalPluggableDatabaseDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExternalPluggableDatabaseDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExternalPluggableDatabaseDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateExternalPluggableDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this CreateExternalPluggableDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateExternalPluggableDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this CreateExternalPluggableDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExternalPluggableDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateExternalPluggableDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExternalPluggableDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateExternalPluggableDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExternalPluggableDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateExternalPluggableDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateExternalPluggableDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateExternalPluggableDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/database_connection_credentails_by_name.py b/src/oci/database/models/database_connection_credentails_by_name.py new file mode 100644 index 0000000000..c8ec6014cd --- /dev/null +++ b/src/oci/database/models/database_connection_credentails_by_name.py @@ -0,0 +1,80 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .database_connection_credentials import DatabaseConnectionCredentials +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class DatabaseConnectionCredentailsByName(DatabaseConnectionCredentials): + """ + Existing named credential used to connect to the database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DatabaseConnectionCredentailsByName object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.DatabaseConnectionCredentailsByName.credential_type` attribute + of this class is ``NAME_REFERENCE`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param credential_type: + The value to assign to the credential_type property of this DatabaseConnectionCredentailsByName. + Allowed values for this property are: "NAME_REFERENCE", "DETAILS" + :type credential_type: str + + :param credential_name: + The value to assign to the credential_name property of this DatabaseConnectionCredentailsByName. + :type credential_name: str + + """ + self.swagger_types = { + 'credential_type': 'str', + 'credential_name': 'str' + } + + self.attribute_map = { + 'credential_type': 'credentialType', + 'credential_name': 'credentialName' + } + + self._credential_type = None + self._credential_name = None + self._credential_type = 'NAME_REFERENCE' + + @property + def credential_name(self): + """ + **[Required]** Gets the credential_name of this DatabaseConnectionCredentailsByName. + The name of the credential information that used to connect to the database. + + + :return: The credential_name of this DatabaseConnectionCredentailsByName. + :rtype: str + """ + return self._credential_name + + @credential_name.setter + def credential_name(self, credential_name): + """ + Sets the credential_name of this DatabaseConnectionCredentailsByName. + The name of the credential information that used to connect to the database. + + + :param credential_name: The credential_name of this DatabaseConnectionCredentailsByName. + :type: str + """ + self._credential_name = credential_name + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/database_connection_credentials.py b/src/oci/database/models/database_connection_credentials.py new file mode 100644 index 0000000000..2b871ee98f --- /dev/null +++ b/src/oci/database/models/database_connection_credentials.py @@ -0,0 +1,107 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class DatabaseConnectionCredentials(object): + """ + Credentials used to connect to the database. + """ + + #: A constant which can be used with the credential_type property of a DatabaseConnectionCredentials. + #: This constant has a value of "NAME_REFERENCE" + CREDENTIAL_TYPE_NAME_REFERENCE = "NAME_REFERENCE" + + #: A constant which can be used with the credential_type property of a DatabaseConnectionCredentials. + #: This constant has a value of "DETAILS" + CREDENTIAL_TYPE_DETAILS = "DETAILS" + + def __init__(self, **kwargs): + """ + Initializes a new DatabaseConnectionCredentials object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.database.models.DatabaseConnectionCredentailsByName` + * :class:`~oci.database.models.DatabaseConnectionCredentialsByDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param credential_type: + The value to assign to the credential_type property of this DatabaseConnectionCredentials. + Allowed values for this property are: "NAME_REFERENCE", "DETAILS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type credential_type: str + + """ + self.swagger_types = { + 'credential_type': 'str' + } + + self.attribute_map = { + 'credential_type': 'credentialType' + } + + self._credential_type = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['credentialType'] + + if type == 'NAME_REFERENCE': + return 'DatabaseConnectionCredentailsByName' + + if type == 'DETAILS': + return 'DatabaseConnectionCredentialsByDetails' + else: + return 'DatabaseConnectionCredentials' + + @property + def credential_type(self): + """ + Gets the credential_type of this DatabaseConnectionCredentials. + The type of credential used to connect to the database. + + Allowed values for this property are: "NAME_REFERENCE", "DETAILS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The credential_type of this DatabaseConnectionCredentials. + :rtype: str + """ + return self._credential_type + + @credential_type.setter + def credential_type(self, credential_type): + """ + Sets the credential_type of this DatabaseConnectionCredentials. + The type of credential used to connect to the database. + + + :param credential_type: The credential_type of this DatabaseConnectionCredentials. + :type: str + """ + allowed_values = ["NAME_REFERENCE", "DETAILS"] + if not value_allowed_none_or_none_sentinel(credential_type, allowed_values): + credential_type = 'UNKNOWN_ENUM_VALUE' + self._credential_type = credential_type + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/database_connection_credentials_by_details.py b/src/oci/database/models/database_connection_credentials_by_details.py new file mode 100644 index 0000000000..3cc4e2facb --- /dev/null +++ b/src/oci/database/models/database_connection_credentials_by_details.py @@ -0,0 +1,190 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .database_connection_credentials import DatabaseConnectionCredentials +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class DatabaseConnectionCredentialsByDetails(DatabaseConnectionCredentials): + """ + User information to connect to the database. + """ + + #: A constant which can be used with the role property of a DatabaseConnectionCredentialsByDetails. + #: This constant has a value of "SYSDBA" + ROLE_SYSDBA = "SYSDBA" + + #: A constant which can be used with the role property of a DatabaseConnectionCredentialsByDetails. + #: This constant has a value of "NORMAL" + ROLE_NORMAL = "NORMAL" + + def __init__(self, **kwargs): + """ + Initializes a new DatabaseConnectionCredentialsByDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.DatabaseConnectionCredentialsByDetails.credential_type` attribute + of this class is ``DETAILS`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param credential_type: + The value to assign to the credential_type property of this DatabaseConnectionCredentialsByDetails. + Allowed values for this property are: "NAME_REFERENCE", "DETAILS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type credential_type: str + + :param credential_name: + The value to assign to the credential_name property of this DatabaseConnectionCredentialsByDetails. + :type credential_name: str + + :param username: + The value to assign to the username property of this DatabaseConnectionCredentialsByDetails. + :type username: str + + :param password: + The value to assign to the password property of this DatabaseConnectionCredentialsByDetails. + :type password: str + + :param role: + The value to assign to the role property of this DatabaseConnectionCredentialsByDetails. + Allowed values for this property are: "SYSDBA", "NORMAL", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type role: str + + """ + self.swagger_types = { + 'credential_type': 'str', + 'credential_name': 'str', + 'username': 'str', + 'password': 'str', + 'role': 'str' + } + + self.attribute_map = { + 'credential_type': 'credentialType', + 'credential_name': 'credentialName', + 'username': 'username', + 'password': 'password', + 'role': 'role' + } + + self._credential_type = None + self._credential_name = None + self._username = None + self._password = None + self._role = None + self._credential_type = 'DETAILS' + + @property + def credential_name(self): + """ + Gets the credential_name of this DatabaseConnectionCredentialsByDetails. + The name of the credential information that used to connect to the database. + + + :return: The credential_name of this DatabaseConnectionCredentialsByDetails. + :rtype: str + """ + return self._credential_name + + @credential_name.setter + def credential_name(self, credential_name): + """ + Sets the credential_name of this DatabaseConnectionCredentialsByDetails. + The name of the credential information that used to connect to the database. + + + :param credential_name: The credential_name of this DatabaseConnectionCredentialsByDetails. + :type: str + """ + self._credential_name = credential_name + + @property + def username(self): + """ + **[Required]** Gets the username of this DatabaseConnectionCredentialsByDetails. + The username that will be used to connect to the database. + + + :return: The username of this DatabaseConnectionCredentialsByDetails. + :rtype: str + """ + return self._username + + @username.setter + def username(self, username): + """ + Sets the username of this DatabaseConnectionCredentialsByDetails. + The username that will be used to connect to the database. + + + :param username: The username of this DatabaseConnectionCredentialsByDetails. + :type: str + """ + self._username = username + + @property + def password(self): + """ + **[Required]** Gets the password of this DatabaseConnectionCredentialsByDetails. + The password that will be used to connect to the database. + + + :return: The password of this DatabaseConnectionCredentialsByDetails. + :rtype: str + """ + return self._password + + @password.setter + def password(self, password): + """ + Sets the password of this DatabaseConnectionCredentialsByDetails. + The password that will be used to connect to the database. + + + :param password: The password of this DatabaseConnectionCredentialsByDetails. + :type: str + """ + self._password = password + + @property + def role(self): + """ + **[Required]** Gets the role of this DatabaseConnectionCredentialsByDetails. + The role of the user that will be connecting to the database. + + Allowed values for this property are: "SYSDBA", "NORMAL", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The role of this DatabaseConnectionCredentialsByDetails. + :rtype: str + """ + return self._role + + @role.setter + def role(self, role): + """ + Sets the role of this DatabaseConnectionCredentialsByDetails. + The role of the user that will be connecting to the database. + + + :param role: The role of this DatabaseConnectionCredentialsByDetails. + :type: str + """ + allowed_values = ["SYSDBA", "NORMAL"] + if not value_allowed_none_or_none_sentinel(role, allowed_values): + role = 'UNKNOWN_ENUM_VALUE' + self._role = role + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/database_connection_string.py b/src/oci/database/models/database_connection_string.py new file mode 100644 index 0000000000..fe9ed04ecf --- /dev/null +++ b/src/oci/database/models/database_connection_string.py @@ -0,0 +1,175 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class DatabaseConnectionString(object): + """ + The Oracle Database connection string. + """ + + #: A constant which can be used with the protocol property of a DatabaseConnectionString. + #: This constant has a value of "TCP" + PROTOCOL_TCP = "TCP" + + def __init__(self, **kwargs): + """ + Initializes a new DatabaseConnectionString object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param hostname: + The value to assign to the hostname property of this DatabaseConnectionString. + :type hostname: str + + :param port: + The value to assign to the port property of this DatabaseConnectionString. + :type port: int + + :param service: + The value to assign to the service property of this DatabaseConnectionString. + :type service: str + + :param protocol: + The value to assign to the protocol property of this DatabaseConnectionString. + Allowed values for this property are: "TCP", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type protocol: str + + """ + self.swagger_types = { + 'hostname': 'str', + 'port': 'int', + 'service': 'str', + 'protocol': 'str' + } + + self.attribute_map = { + 'hostname': 'hostname', + 'port': 'port', + 'service': 'service', + 'protocol': 'protocol' + } + + self._hostname = None + self._port = None + self._service = None + self._protocol = None + + @property + def hostname(self): + """ + **[Required]** Gets the hostname of this DatabaseConnectionString. + The host name of the database. + + + :return: The hostname of this DatabaseConnectionString. + :rtype: str + """ + return self._hostname + + @hostname.setter + def hostname(self, hostname): + """ + Sets the hostname of this DatabaseConnectionString. + The host name of the database. + + + :param hostname: The hostname of this DatabaseConnectionString. + :type: str + """ + self._hostname = hostname + + @property + def port(self): + """ + **[Required]** Gets the port of this DatabaseConnectionString. + The port used to connect to the database. + + + :return: The port of this DatabaseConnectionString. + :rtype: int + """ + return self._port + + @port.setter + def port(self, port): + """ + Sets the port of this DatabaseConnectionString. + The port used to connect to the database. + + + :param port: The port of this DatabaseConnectionString. + :type: int + """ + self._port = port + + @property + def service(self): + """ + **[Required]** Gets the service of this DatabaseConnectionString. + The name of the service alias used to connect to the database. + + + :return: The service of this DatabaseConnectionString. + :rtype: str + """ + return self._service + + @service.setter + def service(self, service): + """ + Sets the service of this DatabaseConnectionString. + The name of the service alias used to connect to the database. + + + :param service: The service of this DatabaseConnectionString. + :type: str + """ + self._service = service + + @property + def protocol(self): + """ + **[Required]** Gets the protocol of this DatabaseConnectionString. + The protocol used to connect to the database. + + Allowed values for this property are: "TCP", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The protocol of this DatabaseConnectionString. + :rtype: str + """ + return self._protocol + + @protocol.setter + def protocol(self, protocol): + """ + Sets the protocol of this DatabaseConnectionString. + The protocol used to connect to the database. + + + :param protocol: The protocol of this DatabaseConnectionString. + :type: str + """ + allowed_values = ["TCP"] + if not value_allowed_none_or_none_sentinel(protocol, allowed_values): + protocol = 'UNKNOWN_ENUM_VALUE' + self._protocol = protocol + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/database_management_config.py b/src/oci/database/models/database_management_config.py new file mode 100644 index 0000000000..219143d631 --- /dev/null +++ b/src/oci/database/models/database_management_config.py @@ -0,0 +1,186 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class DatabaseManagementConfig(object): + """ + The configuration of the Database Management service. + """ + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "ENABLING" + DATABASE_MANAGEMENT_STATUS_ENABLING = "ENABLING" + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "ENABLED" + DATABASE_MANAGEMENT_STATUS_ENABLED = "ENABLED" + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "DISABLING" + DATABASE_MANAGEMENT_STATUS_DISABLING = "DISABLING" + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "NOT_ENABLED" + DATABASE_MANAGEMENT_STATUS_NOT_ENABLED = "NOT_ENABLED" + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "FAILED_ENABLING" + DATABASE_MANAGEMENT_STATUS_FAILED_ENABLING = "FAILED_ENABLING" + + #: A constant which can be used with the database_management_status property of a DatabaseManagementConfig. + #: This constant has a value of "FAILED_DISABLING" + DATABASE_MANAGEMENT_STATUS_FAILED_DISABLING = "FAILED_DISABLING" + + #: A constant which can be used with the license_model property of a DatabaseManagementConfig. + #: This constant has a value of "LICENSE_INCLUDED" + LICENSE_MODEL_LICENSE_INCLUDED = "LICENSE_INCLUDED" + + #: A constant which can be used with the license_model property of a DatabaseManagementConfig. + #: This constant has a value of "BRING_YOUR_OWN_LICENSE" + LICENSE_MODEL_BRING_YOUR_OWN_LICENSE = "BRING_YOUR_OWN_LICENSE" + + def __init__(self, **kwargs): + """ + Initializes a new DatabaseManagementConfig object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param database_management_status: + The value to assign to the database_management_status property of this DatabaseManagementConfig. + Allowed values for this property are: "ENABLING", "ENABLED", "DISABLING", "NOT_ENABLED", "FAILED_ENABLING", "FAILED_DISABLING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_management_status: str + + :param database_management_connection_id: + The value to assign to the database_management_connection_id property of this DatabaseManagementConfig. + :type database_management_connection_id: str + + :param license_model: + The value to assign to the license_model property of this DatabaseManagementConfig. + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type license_model: str + + """ + self.swagger_types = { + 'database_management_status': 'str', + 'database_management_connection_id': 'str', + 'license_model': 'str' + } + + self.attribute_map = { + 'database_management_status': 'databaseManagementStatus', + 'database_management_connection_id': 'databaseManagementConnectionId', + 'license_model': 'licenseModel' + } + + self._database_management_status = None + self._database_management_connection_id = None + self._license_model = None + + @property + def database_management_status(self): + """ + **[Required]** Gets the database_management_status of this DatabaseManagementConfig. + The status of the Database Management service. + + Allowed values for this property are: "ENABLING", "ENABLED", "DISABLING", "NOT_ENABLED", "FAILED_ENABLING", "FAILED_DISABLING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_management_status of this DatabaseManagementConfig. + :rtype: str + """ + return self._database_management_status + + @database_management_status.setter + def database_management_status(self, database_management_status): + """ + Sets the database_management_status of this DatabaseManagementConfig. + The status of the Database Management service. + + + :param database_management_status: The database_management_status of this DatabaseManagementConfig. + :type: str + """ + allowed_values = ["ENABLING", "ENABLED", "DISABLING", "NOT_ENABLED", "FAILED_ENABLING", "FAILED_DISABLING"] + if not value_allowed_none_or_none_sentinel(database_management_status, allowed_values): + database_management_status = 'UNKNOWN_ENUM_VALUE' + self._database_management_status = database_management_status + + @property + def database_management_connection_id(self): + """ + Gets the database_management_connection_id of this DatabaseManagementConfig. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The database_management_connection_id of this DatabaseManagementConfig. + :rtype: str + """ + return self._database_management_connection_id + + @database_management_connection_id.setter + def database_management_connection_id(self, database_management_connection_id): + """ + Sets the database_management_connection_id of this DatabaseManagementConfig. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param database_management_connection_id: The database_management_connection_id of this DatabaseManagementConfig. + :type: str + """ + self._database_management_connection_id = database_management_connection_id + + @property + def license_model(self): + """ + Gets the license_model of this DatabaseManagementConfig. + The Oracle license model that applies to the external database. + + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The license_model of this DatabaseManagementConfig. + :rtype: str + """ + return self._license_model + + @license_model.setter + def license_model(self, license_model): + """ + Sets the license_model of this DatabaseManagementConfig. + The Oracle license model that applies to the external database. + + + :param license_model: The license_model of this DatabaseManagementConfig. + :type: str + """ + allowed_values = ["LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE"] + if not value_allowed_none_or_none_sentinel(license_model, allowed_values): + license_model = 'UNKNOWN_ENUM_VALUE' + self._license_model = license_model + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/enable_external_container_database_database_management_details.py b/src/oci/database/models/enable_external_container_database_database_management_details.py new file mode 100644 index 0000000000..f98e9f3c59 --- /dev/null +++ b/src/oci/database/models/enable_external_container_database_database_management_details.py @@ -0,0 +1,124 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class EnableExternalContainerDatabaseDatabaseManagementDetails(object): + """ + Details to enable Database Management on an external container database. + """ + + #: A constant which can be used with the license_model property of a EnableExternalContainerDatabaseDatabaseManagementDetails. + #: This constant has a value of "LICENSE_INCLUDED" + LICENSE_MODEL_LICENSE_INCLUDED = "LICENSE_INCLUDED" + + #: A constant which can be used with the license_model property of a EnableExternalContainerDatabaseDatabaseManagementDetails. + #: This constant has a value of "BRING_YOUR_OWN_LICENSE" + LICENSE_MODEL_BRING_YOUR_OWN_LICENSE = "BRING_YOUR_OWN_LICENSE" + + def __init__(self, **kwargs): + """ + Initializes a new EnableExternalContainerDatabaseDatabaseManagementDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param license_model: + The value to assign to the license_model property of this EnableExternalContainerDatabaseDatabaseManagementDetails. + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE" + :type license_model: str + + :param external_database_connector_id: + The value to assign to the external_database_connector_id property of this EnableExternalContainerDatabaseDatabaseManagementDetails. + :type external_database_connector_id: str + + """ + self.swagger_types = { + 'license_model': 'str', + 'external_database_connector_id': 'str' + } + + self.attribute_map = { + 'license_model': 'licenseModel', + 'external_database_connector_id': 'externalDatabaseConnectorId' + } + + self._license_model = None + self._external_database_connector_id = None + + @property + def license_model(self): + """ + **[Required]** Gets the license_model of this EnableExternalContainerDatabaseDatabaseManagementDetails. + The Oracle license model that applies to the external database. + + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE" + + + :return: The license_model of this EnableExternalContainerDatabaseDatabaseManagementDetails. + :rtype: str + """ + return self._license_model + + @license_model.setter + def license_model(self, license_model): + """ + Sets the license_model of this EnableExternalContainerDatabaseDatabaseManagementDetails. + The Oracle license model that applies to the external database. + + + :param license_model: The license_model of this EnableExternalContainerDatabaseDatabaseManagementDetails. + :type: str + """ + allowed_values = ["LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE"] + if not value_allowed_none_or_none_sentinel(license_model, allowed_values): + raise ValueError( + "Invalid value for `license_model`, must be None or one of {0}" + .format(allowed_values) + ) + self._license_model = license_model + + @property + def external_database_connector_id(self): + """ + **[Required]** Gets the external_database_connector_id of this EnableExternalContainerDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_connector_id of this EnableExternalContainerDatabaseDatabaseManagementDetails. + :rtype: str + """ + return self._external_database_connector_id + + @external_database_connector_id.setter + def external_database_connector_id(self, external_database_connector_id): + """ + Sets the external_database_connector_id of this EnableExternalContainerDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_connector_id: The external_database_connector_id of this EnableExternalContainerDatabaseDatabaseManagementDetails. + :type: str + """ + self._external_database_connector_id = external_database_connector_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/enable_external_database_management_details_base.py b/src/oci/database/models/enable_external_database_management_details_base.py new file mode 100644 index 0000000000..2634dbb346 --- /dev/null +++ b/src/oci/database/models/enable_external_database_management_details_base.py @@ -0,0 +1,76 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class EnableExternalDatabaseManagementDetailsBase(object): + """ + Details to enable Database Management on an external database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new EnableExternalDatabaseManagementDetailsBase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param external_database_connector_id: + The value to assign to the external_database_connector_id property of this EnableExternalDatabaseManagementDetailsBase. + :type external_database_connector_id: str + + """ + self.swagger_types = { + 'external_database_connector_id': 'str' + } + + self.attribute_map = { + 'external_database_connector_id': 'externalDatabaseConnectorId' + } + + self._external_database_connector_id = None + + @property + def external_database_connector_id(self): + """ + **[Required]** Gets the external_database_connector_id of this EnableExternalDatabaseManagementDetailsBase. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_connector_id of this EnableExternalDatabaseManagementDetailsBase. + :rtype: str + """ + return self._external_database_connector_id + + @external_database_connector_id.setter + def external_database_connector_id(self, external_database_connector_id): + """ + Sets the external_database_connector_id of this EnableExternalDatabaseManagementDetailsBase. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_connector_id: The external_database_connector_id of this EnableExternalDatabaseManagementDetailsBase. + :type: str + """ + self._external_database_connector_id = external_database_connector_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/enable_external_non_container_database_database_management_details.py b/src/oci/database/models/enable_external_non_container_database_database_management_details.py new file mode 100644 index 0000000000..d94ba5f07d --- /dev/null +++ b/src/oci/database/models/enable_external_non_container_database_database_management_details.py @@ -0,0 +1,124 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class EnableExternalNonContainerDatabaseDatabaseManagementDetails(object): + """ + Details to enable Database Management on an external non-container database. + """ + + #: A constant which can be used with the license_model property of a EnableExternalNonContainerDatabaseDatabaseManagementDetails. + #: This constant has a value of "LICENSE_INCLUDED" + LICENSE_MODEL_LICENSE_INCLUDED = "LICENSE_INCLUDED" + + #: A constant which can be used with the license_model property of a EnableExternalNonContainerDatabaseDatabaseManagementDetails. + #: This constant has a value of "BRING_YOUR_OWN_LICENSE" + LICENSE_MODEL_BRING_YOUR_OWN_LICENSE = "BRING_YOUR_OWN_LICENSE" + + def __init__(self, **kwargs): + """ + Initializes a new EnableExternalNonContainerDatabaseDatabaseManagementDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param license_model: + The value to assign to the license_model property of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE" + :type license_model: str + + :param external_database_connector_id: + The value to assign to the external_database_connector_id property of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + :type external_database_connector_id: str + + """ + self.swagger_types = { + 'license_model': 'str', + 'external_database_connector_id': 'str' + } + + self.attribute_map = { + 'license_model': 'licenseModel', + 'external_database_connector_id': 'externalDatabaseConnectorId' + } + + self._license_model = None + self._external_database_connector_id = None + + @property + def license_model(self): + """ + **[Required]** Gets the license_model of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + The Oracle license model that applies to the external database. + + Allowed values for this property are: "LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE" + + + :return: The license_model of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + :rtype: str + """ + return self._license_model + + @license_model.setter + def license_model(self, license_model): + """ + Sets the license_model of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + The Oracle license model that applies to the external database. + + + :param license_model: The license_model of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + :type: str + """ + allowed_values = ["LICENSE_INCLUDED", "BRING_YOUR_OWN_LICENSE"] + if not value_allowed_none_or_none_sentinel(license_model, allowed_values): + raise ValueError( + "Invalid value for `license_model`, must be None or one of {0}" + .format(allowed_values) + ) + self._license_model = license_model + + @property + def external_database_connector_id(self): + """ + **[Required]** Gets the external_database_connector_id of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_connector_id of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + :rtype: str + """ + return self._external_database_connector_id + + @external_database_connector_id.setter + def external_database_connector_id(self, external_database_connector_id): + """ + Sets the external_database_connector_id of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_connector_id: The external_database_connector_id of this EnableExternalNonContainerDatabaseDatabaseManagementDetails. + :type: str + """ + self._external_database_connector_id = external_database_connector_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/enable_external_pluggable_database_database_management_details.py b/src/oci/database/models/enable_external_pluggable_database_database_management_details.py new file mode 100644 index 0000000000..51cd85ef26 --- /dev/null +++ b/src/oci/database/models/enable_external_pluggable_database_database_management_details.py @@ -0,0 +1,76 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class EnableExternalPluggableDatabaseDatabaseManagementDetails(object): + """ + Details to enable Database Management on an external pluggable database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new EnableExternalPluggableDatabaseDatabaseManagementDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param external_database_connector_id: + The value to assign to the external_database_connector_id property of this EnableExternalPluggableDatabaseDatabaseManagementDetails. + :type external_database_connector_id: str + + """ + self.swagger_types = { + 'external_database_connector_id': 'str' + } + + self.attribute_map = { + 'external_database_connector_id': 'externalDatabaseConnectorId' + } + + self._external_database_connector_id = None + + @property + def external_database_connector_id(self): + """ + **[Required]** Gets the external_database_connector_id of this EnableExternalPluggableDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_connector_id of this EnableExternalPluggableDatabaseDatabaseManagementDetails. + :rtype: str + """ + return self._external_database_connector_id + + @external_database_connector_id.setter + def external_database_connector_id(self, external_database_connector_id): + """ + Sets the external_database_connector_id of this EnableExternalPluggableDatabaseDatabaseManagementDetails. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_connector_id: The external_database_connector_id of this EnableExternalPluggableDatabaseDatabaseManagementDetails. + :type: str + """ + self._external_database_connector_id = external_database_connector_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/exadata_infrastructure.py b/src/oci/database/models/exadata_infrastructure.py index 4a7e1ff21f..879e98c3c7 100644 --- a/src/oci/database/models/exadata_infrastructure.py +++ b/src/oci/database/models/exadata_infrastructure.py @@ -57,6 +57,14 @@ class ExadataInfrastructure(object): #: This constant has a value of "MAINTENANCE_IN_PROGRESS" LIFECYCLE_STATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + #: A constant which can be used with the maintenance_slo_status property of a ExadataInfrastructure. + #: This constant has a value of "OK" + MAINTENANCE_SLO_STATUS_OK = "OK" + + #: A constant which can be used with the maintenance_slo_status property of a ExadataInfrastructure. + #: This constant has a value of "DEGRADED" + MAINTENANCE_SLO_STATUS_DEGRADED = "DEGRADED" + def __init__(self, **kwargs): """ Initializes a new ExadataInfrastructure object with values from keyword arguments. @@ -172,6 +180,12 @@ def __init__(self, **kwargs): The value to assign to the contacts property of this ExadataInfrastructure. :type contacts: list[oci.database.models.ExadataInfrastructureContact] + :param maintenance_slo_status: + The value to assign to the maintenance_slo_status property of this ExadataInfrastructure. + Allowed values for this property are: "OK", "DEGRADED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type maintenance_slo_status: str + :param maintenance_window: The value to assign to the maintenance_window property of this ExadataInfrastructure. :type maintenance_window: oci.database.models.MaintenanceWindow @@ -213,6 +227,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'str', 'csi_number': 'str', 'contacts': 'list[ExadataInfrastructureContact]', + 'maintenance_slo_status': 'str', 'maintenance_window': 'MaintenanceWindow', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' @@ -246,6 +261,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'lifecycleDetails', 'csi_number': 'csiNumber', 'contacts': 'contacts', + 'maintenance_slo_status': 'maintenanceSLOStatus', 'maintenance_window': 'maintenanceWindow', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' @@ -278,6 +294,7 @@ def __init__(self, **kwargs): self._lifecycle_details = None self._csi_number = None self._contacts = None + self._maintenance_slo_status = None self._maintenance_window = None self._freeform_tags = None self._defined_tags = None @@ -948,6 +965,36 @@ def contacts(self, contacts): """ self._contacts = contacts + @property + def maintenance_slo_status(self): + """ + Gets the maintenance_slo_status of this ExadataInfrastructure. + A field to capture \u2018Maintenance SLO Status\u2019 for the Exadata infrastructure with values \u2018OK\u2019, \u2018DEGRADED\u2019. Default is \u2018OK\u2019 when the infrastructure is provisioned. + + Allowed values for this property are: "OK", "DEGRADED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The maintenance_slo_status of this ExadataInfrastructure. + :rtype: str + """ + return self._maintenance_slo_status + + @maintenance_slo_status.setter + def maintenance_slo_status(self, maintenance_slo_status): + """ + Sets the maintenance_slo_status of this ExadataInfrastructure. + A field to capture \u2018Maintenance SLO Status\u2019 for the Exadata infrastructure with values \u2018OK\u2019, \u2018DEGRADED\u2019. Default is \u2018OK\u2019 when the infrastructure is provisioned. + + + :param maintenance_slo_status: The maintenance_slo_status of this ExadataInfrastructure. + :type: str + """ + allowed_values = ["OK", "DEGRADED"] + if not value_allowed_none_or_none_sentinel(maintenance_slo_status, allowed_values): + maintenance_slo_status = 'UNKNOWN_ENUM_VALUE' + self._maintenance_slo_status = maintenance_slo_status + @property def maintenance_window(self): """ diff --git a/src/oci/database/models/exadata_infrastructure_contact.py b/src/oci/database/models/exadata_infrastructure_contact.py index 66f347721c..7994637e99 100644 --- a/src/oci/database/models/exadata_infrastructure_contact.py +++ b/src/oci/database/models/exadata_infrastructure_contact.py @@ -34,25 +34,32 @@ def __init__(self, **kwargs): The value to assign to the is_primary property of this ExadataInfrastructureContact. :type is_primary: bool + :param is_contact_mos_validated: + The value to assign to the is_contact_mos_validated property of this ExadataInfrastructureContact. + :type is_contact_mos_validated: bool + """ self.swagger_types = { 'name': 'str', 'phone_number': 'str', 'email': 'str', - 'is_primary': 'bool' + 'is_primary': 'bool', + 'is_contact_mos_validated': 'bool' } self.attribute_map = { 'name': 'name', 'phone_number': 'phoneNumber', 'email': 'email', - 'is_primary': 'isPrimary' + 'is_primary': 'isPrimary', + 'is_contact_mos_validated': 'isContactMosValidated' } self._name = None self._phone_number = None self._email = None self._is_primary = None + self._is_contact_mos_validated = None @property def name(self): @@ -130,7 +137,7 @@ def email(self, email): def is_primary(self): """ **[Required]** Gets the is_primary of this ExadataInfrastructureContact. - True, if this Exadata Infrastructure contact is a primary contact. False, if this Exadata Infrastructure is a secondary contact. + If `true`, this Exadata Infrastructure contact is a primary contact. If `false`, this Exadata Infrastructure is a secondary contact. :return: The is_primary of this ExadataInfrastructureContact. @@ -142,7 +149,7 @@ def is_primary(self): def is_primary(self, is_primary): """ Sets the is_primary of this ExadataInfrastructureContact. - True, if this Exadata Infrastructure contact is a primary contact. False, if this Exadata Infrastructure is a secondary contact. + If `true`, this Exadata Infrastructure contact is a primary contact. If `false`, this Exadata Infrastructure is a secondary contact. :param is_primary: The is_primary of this ExadataInfrastructureContact. @@ -150,6 +157,30 @@ def is_primary(self, is_primary): """ self._is_primary = is_primary + @property + def is_contact_mos_validated(self): + """ + Gets the is_contact_mos_validated of this ExadataInfrastructureContact. + If `true`, this Exadata Infrastructure contact is a valid My Oracle Support (MOS) contact. If `false`, this Exadata Infrastructure contact is not a valid MOS contact. + + + :return: The is_contact_mos_validated of this ExadataInfrastructureContact. + :rtype: bool + """ + return self._is_contact_mos_validated + + @is_contact_mos_validated.setter + def is_contact_mos_validated(self, is_contact_mos_validated): + """ + Sets the is_contact_mos_validated of this ExadataInfrastructureContact. + If `true`, this Exadata Infrastructure contact is a valid My Oracle Support (MOS) contact. If `false`, this Exadata Infrastructure contact is not a valid MOS contact. + + + :param is_contact_mos_validated: The is_contact_mos_validated of this ExadataInfrastructureContact. + :type: bool + """ + self._is_contact_mos_validated = is_contact_mos_validated + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/exadata_infrastructure_summary.py b/src/oci/database/models/exadata_infrastructure_summary.py index d7849bfdad..df180634dd 100644 --- a/src/oci/database/models/exadata_infrastructure_summary.py +++ b/src/oci/database/models/exadata_infrastructure_summary.py @@ -58,6 +58,14 @@ class ExadataInfrastructureSummary(object): #: This constant has a value of "MAINTENANCE_IN_PROGRESS" LIFECYCLE_STATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + #: A constant which can be used with the maintenance_slo_status property of a ExadataInfrastructureSummary. + #: This constant has a value of "OK" + MAINTENANCE_SLO_STATUS_OK = "OK" + + #: A constant which can be used with the maintenance_slo_status property of a ExadataInfrastructureSummary. + #: This constant has a value of "DEGRADED" + MAINTENANCE_SLO_STATUS_DEGRADED = "DEGRADED" + def __init__(self, **kwargs): """ Initializes a new ExadataInfrastructureSummary object with values from keyword arguments. @@ -173,6 +181,12 @@ def __init__(self, **kwargs): The value to assign to the contacts property of this ExadataInfrastructureSummary. :type contacts: list[oci.database.models.ExadataInfrastructureContact] + :param maintenance_slo_status: + The value to assign to the maintenance_slo_status property of this ExadataInfrastructureSummary. + Allowed values for this property are: "OK", "DEGRADED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type maintenance_slo_status: str + :param maintenance_window: The value to assign to the maintenance_window property of this ExadataInfrastructureSummary. :type maintenance_window: oci.database.models.MaintenanceWindow @@ -214,6 +228,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'str', 'csi_number': 'str', 'contacts': 'list[ExadataInfrastructureContact]', + 'maintenance_slo_status': 'str', 'maintenance_window': 'MaintenanceWindow', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' @@ -247,6 +262,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'lifecycleDetails', 'csi_number': 'csiNumber', 'contacts': 'contacts', + 'maintenance_slo_status': 'maintenanceSLOStatus', 'maintenance_window': 'maintenanceWindow', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' @@ -279,6 +295,7 @@ def __init__(self, **kwargs): self._lifecycle_details = None self._csi_number = None self._contacts = None + self._maintenance_slo_status = None self._maintenance_window = None self._freeform_tags = None self._defined_tags = None @@ -949,6 +966,36 @@ def contacts(self, contacts): """ self._contacts = contacts + @property + def maintenance_slo_status(self): + """ + Gets the maintenance_slo_status of this ExadataInfrastructureSummary. + A field to capture \u2018Maintenance SLO Status\u2019 for the Exadata infrastructure with values \u2018OK\u2019, \u2018DEGRADED\u2019. Default is \u2018OK\u2019 when the infrastructure is provisioned. + + Allowed values for this property are: "OK", "DEGRADED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The maintenance_slo_status of this ExadataInfrastructureSummary. + :rtype: str + """ + return self._maintenance_slo_status + + @maintenance_slo_status.setter + def maintenance_slo_status(self, maintenance_slo_status): + """ + Sets the maintenance_slo_status of this ExadataInfrastructureSummary. + A field to capture \u2018Maintenance SLO Status\u2019 for the Exadata infrastructure with values \u2018OK\u2019, \u2018DEGRADED\u2019. Default is \u2018OK\u2019 when the infrastructure is provisioned. + + + :param maintenance_slo_status: The maintenance_slo_status of this ExadataInfrastructureSummary. + :type: str + """ + allowed_values = ["OK", "DEGRADED"] + if not value_allowed_none_or_none_sentinel(maintenance_slo_status, allowed_values): + maintenance_slo_status = 'UNKNOWN_ENUM_VALUE' + self._maintenance_slo_status = maintenance_slo_status + @property def maintenance_window(self): """ diff --git a/src/oci/database/models/external_container_database.py b/src/oci/database/models/external_container_database.py new file mode 100644 index 0000000000..fb02f28358 --- /dev/null +++ b/src/oci/database/models/external_container_database.py @@ -0,0 +1,650 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalContainerDatabase(object): + """ + An Oracle Cloud Infrastructure resource that allows you to manage an external container database. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabase. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabase. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalContainerDatabase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalContainerDatabase. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalContainerDatabase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalContainerDatabase. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalContainerDatabase. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalContainerDatabase. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalContainerDatabase. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalContainerDatabase. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalContainerDatabase. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalContainerDatabase. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalContainerDatabase. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalContainerDatabase. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalContainerDatabase. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalContainerDatabase. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalContainerDatabase. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalContainerDatabase. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalContainerDatabase. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalContainerDatabase. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalContainerDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalContainerDatabase. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalContainerDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalContainerDatabase. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalContainerDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalContainerDatabase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalContainerDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalContainerDatabase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalContainerDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalContainerDatabase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalContainerDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalContainerDatabase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalContainerDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalContainerDatabase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalContainerDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalContainerDatabase. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalContainerDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalContainerDatabase. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalContainerDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalContainerDatabase. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalContainerDatabase. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalContainerDatabase. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalContainerDatabase. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalContainerDatabase. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalContainerDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalContainerDatabase. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalContainerDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalContainerDatabase. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalContainerDatabase. + The date and time the database was created. + + + :return: The time_created of this ExternalContainerDatabase. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalContainerDatabase. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalContainerDatabase. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalContainerDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalContainerDatabase. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalContainerDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalContainerDatabase. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalContainerDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalContainerDatabase. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalContainerDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalContainerDatabase. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalContainerDatabase. + The Oracle Database version. + + + :return: The database_version of this ExternalContainerDatabase. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalContainerDatabase. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalContainerDatabase. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalContainerDatabase. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalContainerDatabase. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalContainerDatabase. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalContainerDatabase. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalContainerDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalContainerDatabase. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalContainerDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalContainerDatabase. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalContainerDatabase. + The character set of the external database. + + + :return: The character_set of this ExternalContainerDatabase. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalContainerDatabase. + The character set of the external database. + + + :param character_set: The character_set of this ExternalContainerDatabase. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalContainerDatabase. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalContainerDatabase. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalContainerDatabase. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalContainerDatabase. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalContainerDatabase. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalContainerDatabase. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalContainerDatabase. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalContainerDatabase. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalContainerDatabase. + + :return: The database_management_config of this ExternalContainerDatabase. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalContainerDatabase. + + :param database_management_config: The database_management_config of this ExternalContainerDatabase. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_container_database_summary.py b/src/oci/database/models/external_container_database_summary.py new file mode 100644 index 0000000000..8a04e803e6 --- /dev/null +++ b/src/oci/database/models/external_container_database_summary.py @@ -0,0 +1,650 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalContainerDatabaseSummary(object): + """ + An Oracle Cloud Infrastructure resource that allows you to manage an external Oracle container database. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalContainerDatabaseSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalContainerDatabaseSummary. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalContainerDatabaseSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalContainerDatabaseSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalContainerDatabaseSummary. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalContainerDatabaseSummary. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalContainerDatabaseSummary. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalContainerDatabaseSummary. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalContainerDatabaseSummary. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalContainerDatabaseSummary. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalContainerDatabaseSummary. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalContainerDatabaseSummary. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalContainerDatabaseSummary. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalContainerDatabaseSummary. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalContainerDatabaseSummary. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalContainerDatabaseSummary. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalContainerDatabaseSummary. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalContainerDatabaseSummary. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalContainerDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalContainerDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalContainerDatabaseSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalContainerDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalContainerDatabaseSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalContainerDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalContainerDatabaseSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalContainerDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalContainerDatabaseSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalContainerDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalContainerDatabaseSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalContainerDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalContainerDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalContainerDatabaseSummary. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalContainerDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalContainerDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalContainerDatabaseSummary. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalContainerDatabaseSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalContainerDatabaseSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalContainerDatabaseSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalContainerDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalContainerDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalContainerDatabaseSummary. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalContainerDatabaseSummary. + The date and time the database was created. + + + :return: The time_created of this ExternalContainerDatabaseSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalContainerDatabaseSummary. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalContainerDatabaseSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalContainerDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalContainerDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalContainerDatabaseSummary. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalContainerDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalContainerDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalContainerDatabaseSummary. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalContainerDatabaseSummary. + The Oracle Database version. + + + :return: The database_version of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalContainerDatabaseSummary. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalContainerDatabaseSummary. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalContainerDatabaseSummary. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalContainerDatabaseSummary. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalContainerDatabaseSummary. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalContainerDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalContainerDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalContainerDatabaseSummary. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalContainerDatabaseSummary. + The character set of the external database. + + + :return: The character_set of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalContainerDatabaseSummary. + The character set of the external database. + + + :param character_set: The character_set of this ExternalContainerDatabaseSummary. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalContainerDatabaseSummary. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalContainerDatabaseSummary. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalContainerDatabaseSummary. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalContainerDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalContainerDatabaseSummary. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalContainerDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalContainerDatabaseSummary. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalContainerDatabaseSummary. + + :return: The database_management_config of this ExternalContainerDatabaseSummary. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalContainerDatabaseSummary. + + :param database_management_config: The database_management_config of this ExternalContainerDatabaseSummary. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_database_base.py b/src/oci/database/models/external_database_base.py new file mode 100644 index 0000000000..d5920cb85d --- /dev/null +++ b/src/oci/database/models/external_database_base.py @@ -0,0 +1,652 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalDatabaseBase(object): + """ + A resource that allows you to manage an Oracle Database located outside of Oracle Cloud using Oracle Cloud Infrastructure's Console and APIs. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseBase. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalDatabaseBase. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalDatabaseBase. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalDatabaseBase. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalDatabaseBase. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalDatabaseBase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalDatabaseBase. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalDatabaseBase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalDatabaseBase. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalDatabaseBase. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalDatabaseBase. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalDatabaseBase. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalDatabaseBase. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalDatabaseBase. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalDatabaseBase. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalDatabaseBase. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalDatabaseBase. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalDatabaseBase. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalDatabaseBase. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalDatabaseBase. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalDatabaseBase. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalDatabaseBase. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalDatabaseBase. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalDatabaseBase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalDatabaseBase. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalDatabaseBase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalDatabaseBase. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalDatabaseBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalDatabaseBase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalDatabaseBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalDatabaseBase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalDatabaseBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalDatabaseBase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalDatabaseBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalDatabaseBase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalDatabaseBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalDatabaseBase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalDatabaseBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalDatabaseBase. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalDatabaseBase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalDatabaseBase. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalDatabaseBase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalDatabaseBase. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalDatabaseBase. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalDatabaseBase. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalDatabaseBase. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalDatabaseBase. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalDatabaseBase. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + + + :return: The lifecycle_state of this ExternalDatabaseBase. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalDatabaseBase. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalDatabaseBase. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + raise ValueError( + "Invalid value for `lifecycle_state`, must be None or one of {0}" + .format(allowed_values) + ) + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalDatabaseBase. + The date and time the database was created. + + + :return: The time_created of this ExternalDatabaseBase. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalDatabaseBase. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalDatabaseBase. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalDatabaseBase. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalDatabaseBase. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalDatabaseBase. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalDatabaseBase. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalDatabaseBase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalDatabaseBase. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalDatabaseBase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalDatabaseBase. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalDatabaseBase. + The Oracle Database version. + + + :return: The database_version of this ExternalDatabaseBase. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalDatabaseBase. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalDatabaseBase. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalDatabaseBase. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + + :return: The database_edition of this ExternalDatabaseBase. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalDatabaseBase. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalDatabaseBase. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + raise ValueError( + "Invalid value for `database_edition`, must be None or one of {0}" + .format(allowed_values) + ) + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalDatabaseBase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalDatabaseBase. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalDatabaseBase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalDatabaseBase. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalDatabaseBase. + The character set of the external database. + + + :return: The character_set of this ExternalDatabaseBase. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalDatabaseBase. + The character set of the external database. + + + :param character_set: The character_set of this ExternalDatabaseBase. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalDatabaseBase. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalDatabaseBase. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalDatabaseBase. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalDatabaseBase. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalDatabaseBase. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalDatabaseBase. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalDatabaseBase. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalDatabaseBase. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalDatabaseBase. + + :return: The database_management_config of this ExternalDatabaseBase. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalDatabaseBase. + + :param database_management_config: The database_management_config of this ExternalDatabaseBase. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_database_connector.py b/src/oci/database/models/external_database_connector.py new file mode 100644 index 0000000000..73ef0c4bcd --- /dev/null +++ b/src/oci/database/models/external_database_connector.py @@ -0,0 +1,508 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalDatabaseConnector(object): + """ + An Oracle Cloud Infrastructure resource used to connect to an external Oracle Database. + This resource stores the database connection string, user credentials, and related details that allow you to + manage your external database using the Oracle Cloud Infrastructure Console and API interfaces. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalDatabaseConnector. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the connector_type property of a ExternalDatabaseConnector. + #: This constant has a value of "MACS" + CONNECTOR_TYPE_MACS = "MACS" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalDatabaseConnector object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.database.models.ExternalMacsConnector` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalDatabaseConnector. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalDatabaseConnector. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalDatabaseConnector. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalDatabaseConnector. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalDatabaseConnector. + :type id: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalDatabaseConnector. + Allowed values for this property are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalDatabaseConnector. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExternalDatabaseConnector. + :type time_created: datetime + + :param connector_type: + The value to assign to the connector_type property of this ExternalDatabaseConnector. + Allowed values for this property are: "MACS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this ExternalDatabaseConnector. + :type external_database_id: str + + :param connection_status: + The value to assign to the connection_status property of this ExternalDatabaseConnector. + :type connection_status: str + + :param time_connection_status_last_updated: + The value to assign to the time_connection_status_last_updated property of this ExternalDatabaseConnector. + :type time_connection_status_last_updated: datetime + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'connector_type': 'str', + 'external_database_id': 'str', + 'connection_status': 'str', + 'time_connection_status_last_updated': 'datetime' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId', + 'connection_status': 'connectionStatus', + 'time_connection_status_last_updated': 'timeConnectionStatusLastUpdated' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._connector_type = None + self._external_database_id = None + self._connection_status = None + self._time_connection_status_last_updated = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['connectorType'] + + if type == 'MACS': + return 'ExternalMacsConnector' + else: + return 'ExternalDatabaseConnector' + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalDatabaseConnector. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalDatabaseConnector. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalDatabaseConnector. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalDatabaseConnector. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalDatabaseConnector. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalDatabaseConnector. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalDatabaseConnector. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalDatabaseConnector. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalDatabaseConnector. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalDatabaseConnector. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalDatabaseConnector. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalDatabaseConnector. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalDatabaseConnector. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :return: The display_name of this ExternalDatabaseConnector. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalDatabaseConnector. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :param display_name: The display_name of this ExternalDatabaseConnector. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalDatabaseConnector. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalDatabaseConnector. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalDatabaseConnector. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalDatabaseConnector. + :type: str + """ + self._id = id + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalDatabaseConnector. + The current lifecycle state of the external database connector resource. + + Allowed values for this property are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalDatabaseConnector. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalDatabaseConnector. + The current lifecycle state of the external database connector resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalDatabaseConnector. + :type: str + """ + allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalDatabaseConnector. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalDatabaseConnector. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalDatabaseConnector. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalDatabaseConnector. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalDatabaseConnector. + The date and time the external connector was created. + + + :return: The time_created of this ExternalDatabaseConnector. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalDatabaseConnector. + The date and time the external connector was created. + + + :param time_created: The time_created of this ExternalDatabaseConnector. + :type: datetime + """ + self._time_created = time_created + + @property + def connector_type(self): + """ + **[Required]** Gets the connector_type of this ExternalDatabaseConnector. + The type of connector used by the external database resource. + + Allowed values for this property are: "MACS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The connector_type of this ExternalDatabaseConnector. + :rtype: str + """ + return self._connector_type + + @connector_type.setter + def connector_type(self, connector_type): + """ + Sets the connector_type of this ExternalDatabaseConnector. + The type of connector used by the external database resource. + + + :param connector_type: The connector_type of this ExternalDatabaseConnector. + :type: str + """ + allowed_values = ["MACS"] + if not value_allowed_none_or_none_sentinel(connector_type, allowed_values): + connector_type = 'UNKNOWN_ENUM_VALUE' + self._connector_type = connector_type + + @property + def external_database_id(self): + """ + **[Required]** Gets the external_database_id of this ExternalDatabaseConnector. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_id of this ExternalDatabaseConnector. + :rtype: str + """ + return self._external_database_id + + @external_database_id.setter + def external_database_id(self, external_database_id): + """ + Sets the external_database_id of this ExternalDatabaseConnector. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_id: The external_database_id of this ExternalDatabaseConnector. + :type: str + """ + self._external_database_id = external_database_id + + @property + def connection_status(self): + """ + **[Required]** Gets the connection_status of this ExternalDatabaseConnector. + The status of connectivity to the external database. + + + :return: The connection_status of this ExternalDatabaseConnector. + :rtype: str + """ + return self._connection_status + + @connection_status.setter + def connection_status(self, connection_status): + """ + Sets the connection_status of this ExternalDatabaseConnector. + The status of connectivity to the external database. + + + :param connection_status: The connection_status of this ExternalDatabaseConnector. + :type: str + """ + self._connection_status = connection_status + + @property + def time_connection_status_last_updated(self): + """ + **[Required]** Gets the time_connection_status_last_updated of this ExternalDatabaseConnector. + The date and time the connectionStatus of this external connector was last updated. + + + :return: The time_connection_status_last_updated of this ExternalDatabaseConnector. + :rtype: datetime + """ + return self._time_connection_status_last_updated + + @time_connection_status_last_updated.setter + def time_connection_status_last_updated(self, time_connection_status_last_updated): + """ + Sets the time_connection_status_last_updated of this ExternalDatabaseConnector. + The date and time the connectionStatus of this external connector was last updated. + + + :param time_connection_status_last_updated: The time_connection_status_last_updated of this ExternalDatabaseConnector. + :type: datetime + """ + self._time_connection_status_last_updated = time_connection_status_last_updated + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_database_connector_summary.py b/src/oci/database/models/external_database_connector_summary.py new file mode 100644 index 0000000000..24c33c9a4a --- /dev/null +++ b/src/oci/database/models/external_database_connector_summary.py @@ -0,0 +1,476 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalDatabaseConnectorSummary(object): + """ + An Oracle Cloud Infrastructure resource used to connect to an external Oracle Database. + This resource stores the database connection string, user credentials, and related details that allow you to + manage your external database using the Oracle Cloud Infrastructure Console and API interfaces. + """ + + #: A constant which can be used with the connector_type property of a ExternalDatabaseConnectorSummary. + #: This constant has a value of "MACS" + CONNECTOR_TYPE_MACS = "MACS" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalDatabaseConnectorSummary object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.database.models.ExternalMacsConnectorSummary` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalDatabaseConnectorSummary. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalDatabaseConnectorSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalDatabaseConnectorSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalDatabaseConnectorSummary. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalDatabaseConnectorSummary. + :type id: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalDatabaseConnectorSummary. + :type lifecycle_state: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalDatabaseConnectorSummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExternalDatabaseConnectorSummary. + :type time_created: datetime + + :param connector_type: + The value to assign to the connector_type property of this ExternalDatabaseConnectorSummary. + Allowed values for this property are: "MACS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this ExternalDatabaseConnectorSummary. + :type external_database_id: str + + :param connection_status: + The value to assign to the connection_status property of this ExternalDatabaseConnectorSummary. + :type connection_status: str + + :param time_connection_status_last_updated: + The value to assign to the time_connection_status_last_updated property of this ExternalDatabaseConnectorSummary. + :type time_connection_status_last_updated: datetime + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'connector_type': 'str', + 'external_database_id': 'str', + 'connection_status': 'str', + 'time_connection_status_last_updated': 'datetime' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId', + 'connection_status': 'connectionStatus', + 'time_connection_status_last_updated': 'timeConnectionStatusLastUpdated' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._connector_type = None + self._external_database_id = None + self._connection_status = None + self._time_connection_status_last_updated = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['connectorType'] + + if type == 'MACS': + return 'ExternalMacsConnectorSummary' + else: + return 'ExternalDatabaseConnectorSummary' + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalDatabaseConnectorSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalDatabaseConnectorSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalDatabaseConnectorSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalDatabaseConnectorSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalDatabaseConnectorSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalDatabaseConnectorSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalDatabaseConnectorSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalDatabaseConnectorSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalDatabaseConnectorSummary. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :return: The display_name of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalDatabaseConnectorSummary. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :param display_name: The display_name of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the + :func:`create_external_database_connector_details`. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._id = id + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalDatabaseConnectorSummary. + The current lifecycle state of the external database connector resource. + + + :return: The lifecycle_state of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalDatabaseConnectorSummary. + The current lifecycle state of the external database connector resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalDatabaseConnectorSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalDatabaseConnectorSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalDatabaseConnectorSummary. + The date and time the external connector was created. + + + :return: The time_created of this ExternalDatabaseConnectorSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalDatabaseConnectorSummary. + The date and time the external connector was created. + + + :param time_created: The time_created of this ExternalDatabaseConnectorSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def connector_type(self): + """ + **[Required]** Gets the connector_type of this ExternalDatabaseConnectorSummary. + The type of connector used by the external database resource. + + Allowed values for this property are: "MACS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The connector_type of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._connector_type + + @connector_type.setter + def connector_type(self, connector_type): + """ + Sets the connector_type of this ExternalDatabaseConnectorSummary. + The type of connector used by the external database resource. + + + :param connector_type: The connector_type of this ExternalDatabaseConnectorSummary. + :type: str + """ + allowed_values = ["MACS"] + if not value_allowed_none_or_none_sentinel(connector_type, allowed_values): + connector_type = 'UNKNOWN_ENUM_VALUE' + self._connector_type = connector_type + + @property + def external_database_id(self): + """ + **[Required]** Gets the external_database_id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The external_database_id of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._external_database_id + + @external_database_id.setter + def external_database_id(self, external_database_id): + """ + Sets the external_database_id of this ExternalDatabaseConnectorSummary. + The `OCID`__ of the external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param external_database_id: The external_database_id of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._external_database_id = external_database_id + + @property + def connection_status(self): + """ + **[Required]** Gets the connection_status of this ExternalDatabaseConnectorSummary. + The status of connectivity to the external database. + + + :return: The connection_status of this ExternalDatabaseConnectorSummary. + :rtype: str + """ + return self._connection_status + + @connection_status.setter + def connection_status(self, connection_status): + """ + Sets the connection_status of this ExternalDatabaseConnectorSummary. + The status of connectivity to the external database. + + + :param connection_status: The connection_status of this ExternalDatabaseConnectorSummary. + :type: str + """ + self._connection_status = connection_status + + @property + def time_connection_status_last_updated(self): + """ + **[Required]** Gets the time_connection_status_last_updated of this ExternalDatabaseConnectorSummary. + The date and time the `connectionStatus` of this external connector was last updated. + + + :return: The time_connection_status_last_updated of this ExternalDatabaseConnectorSummary. + :rtype: datetime + """ + return self._time_connection_status_last_updated + + @time_connection_status_last_updated.setter + def time_connection_status_last_updated(self, time_connection_status_last_updated): + """ + Sets the time_connection_status_last_updated of this ExternalDatabaseConnectorSummary. + The date and time the `connectionStatus` of this external connector was last updated. + + + :param time_connection_status_last_updated: The time_connection_status_last_updated of this ExternalDatabaseConnectorSummary. + :type: datetime + """ + self._time_connection_status_last_updated = time_connection_status_last_updated + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_macs_connector.py b/src/oci/database/models/external_macs_connector.py new file mode 100644 index 0000000000..48be59e5e7 --- /dev/null +++ b/src/oci/database/models/external_macs_connector.py @@ -0,0 +1,216 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .external_database_connector import ExternalDatabaseConnector +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalMacsConnector(ExternalDatabaseConnector): + """ + An Oracle Cloud Infrastructure resource that uses the `Management Agent cloud service (MACS)`__ to connect to an external Oracle Database. + + __ https://docs.cloud.oracle.com/iaas/management-agents/index.html + """ + + def __init__(self, **kwargs): + """ + Initializes a new ExternalMacsConnector object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.ExternalMacsConnector.connector_type` attribute + of this class is ``MACS`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalMacsConnector. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalMacsConnector. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalMacsConnector. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalMacsConnector. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalMacsConnector. + :type id: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalMacsConnector. + Allowed values for this property are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + :type lifecycle_state: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalMacsConnector. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExternalMacsConnector. + :type time_created: datetime + + :param connector_type: + The value to assign to the connector_type property of this ExternalMacsConnector. + Allowed values for this property are: "MACS" + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this ExternalMacsConnector. + :type external_database_id: str + + :param connection_status: + The value to assign to the connection_status property of this ExternalMacsConnector. + :type connection_status: str + + :param time_connection_status_last_updated: + The value to assign to the time_connection_status_last_updated property of this ExternalMacsConnector. + :type time_connection_status_last_updated: datetime + + :param connection_string: + The value to assign to the connection_string property of this ExternalMacsConnector. + :type connection_string: oci.database.models.DatabaseConnectionString + + :param connection_credentials: + The value to assign to the connection_credentials property of this ExternalMacsConnector. + :type connection_credentials: oci.database.models.DatabaseConnectionCredentials + + :param connector_agent_id: + The value to assign to the connector_agent_id property of this ExternalMacsConnector. + :type connector_agent_id: str + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'connector_type': 'str', + 'external_database_id': 'str', + 'connection_status': 'str', + 'time_connection_status_last_updated': 'datetime', + 'connection_string': 'DatabaseConnectionString', + 'connection_credentials': 'DatabaseConnectionCredentials', + 'connector_agent_id': 'str' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId', + 'connection_status': 'connectionStatus', + 'time_connection_status_last_updated': 'timeConnectionStatusLastUpdated', + 'connection_string': 'connectionString', + 'connection_credentials': 'connectionCredentials', + 'connector_agent_id': 'connectorAgentId' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._connector_type = None + self._external_database_id = None + self._connection_status = None + self._time_connection_status_last_updated = None + self._connection_string = None + self._connection_credentials = None + self._connector_agent_id = None + self._connector_type = 'MACS' + + @property + def connection_string(self): + """ + **[Required]** Gets the connection_string of this ExternalMacsConnector. + + :return: The connection_string of this ExternalMacsConnector. + :rtype: oci.database.models.DatabaseConnectionString + """ + return self._connection_string + + @connection_string.setter + def connection_string(self, connection_string): + """ + Sets the connection_string of this ExternalMacsConnector. + + :param connection_string: The connection_string of this ExternalMacsConnector. + :type: oci.database.models.DatabaseConnectionString + """ + self._connection_string = connection_string + + @property + def connection_credentials(self): + """ + **[Required]** Gets the connection_credentials of this ExternalMacsConnector. + + :return: The connection_credentials of this ExternalMacsConnector. + :rtype: oci.database.models.DatabaseConnectionCredentials + """ + return self._connection_credentials + + @connection_credentials.setter + def connection_credentials(self, connection_credentials): + """ + Sets the connection_credentials of this ExternalMacsConnector. + + :param connection_credentials: The connection_credentials of this ExternalMacsConnector. + :type: oci.database.models.DatabaseConnectionCredentials + """ + self._connection_credentials = connection_credentials + + @property + def connector_agent_id(self): + """ + **[Required]** Gets the connector_agent_id of this ExternalMacsConnector. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :return: The connector_agent_id of this ExternalMacsConnector. + :rtype: str + """ + return self._connector_agent_id + + @connector_agent_id.setter + def connector_agent_id(self, connector_agent_id): + """ + Sets the connector_agent_id of this ExternalMacsConnector. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :param connector_agent_id: The connector_agent_id of this ExternalMacsConnector. + :type: str + """ + self._connector_agent_id = connector_agent_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_macs_connector_summary.py b/src/oci/database/models/external_macs_connector_summary.py new file mode 100644 index 0000000000..3e54e18841 --- /dev/null +++ b/src/oci/database/models/external_macs_connector_summary.py @@ -0,0 +1,215 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .external_database_connector_summary import ExternalDatabaseConnectorSummary +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalMacsConnectorSummary(ExternalDatabaseConnectorSummary): + """ + An Oracle Cloud Infrastructure resource that uses the `Management Agent cloud service (MACS)`__ to connect to an external Oracle Database. + + __ https://docs.cloud.oracle.com/iaas/management-agents/index.html + """ + + def __init__(self, **kwargs): + """ + Initializes a new ExternalMacsConnectorSummary object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.ExternalMacsConnectorSummary.connector_type` attribute + of this class is ``MACS`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalMacsConnectorSummary. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalMacsConnectorSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalMacsConnectorSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalMacsConnectorSummary. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalMacsConnectorSummary. + :type id: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalMacsConnectorSummary. + :type lifecycle_state: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalMacsConnectorSummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExternalMacsConnectorSummary. + :type time_created: datetime + + :param connector_type: + The value to assign to the connector_type property of this ExternalMacsConnectorSummary. + Allowed values for this property are: "MACS" + :type connector_type: str + + :param external_database_id: + The value to assign to the external_database_id property of this ExternalMacsConnectorSummary. + :type external_database_id: str + + :param connection_status: + The value to assign to the connection_status property of this ExternalMacsConnectorSummary. + :type connection_status: str + + :param time_connection_status_last_updated: + The value to assign to the time_connection_status_last_updated property of this ExternalMacsConnectorSummary. + :type time_connection_status_last_updated: datetime + + :param connection_string: + The value to assign to the connection_string property of this ExternalMacsConnectorSummary. + :type connection_string: oci.database.models.DatabaseConnectionString + + :param connection_credentials: + The value to assign to the connection_credentials property of this ExternalMacsConnectorSummary. + :type connection_credentials: oci.database.models.DatabaseConnectionCredentials + + :param connector_agent_id: + The value to assign to the connector_agent_id property of this ExternalMacsConnectorSummary. + :type connector_agent_id: str + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'connector_type': 'str', + 'external_database_id': 'str', + 'connection_status': 'str', + 'time_connection_status_last_updated': 'datetime', + 'connection_string': 'DatabaseConnectionString', + 'connection_credentials': 'DatabaseConnectionCredentials', + 'connector_agent_id': 'str' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'connector_type': 'connectorType', + 'external_database_id': 'externalDatabaseId', + 'connection_status': 'connectionStatus', + 'time_connection_status_last_updated': 'timeConnectionStatusLastUpdated', + 'connection_string': 'connectionString', + 'connection_credentials': 'connectionCredentials', + 'connector_agent_id': 'connectorAgentId' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._connector_type = None + self._external_database_id = None + self._connection_status = None + self._time_connection_status_last_updated = None + self._connection_string = None + self._connection_credentials = None + self._connector_agent_id = None + self._connector_type = 'MACS' + + @property + def connection_string(self): + """ + **[Required]** Gets the connection_string of this ExternalMacsConnectorSummary. + + :return: The connection_string of this ExternalMacsConnectorSummary. + :rtype: oci.database.models.DatabaseConnectionString + """ + return self._connection_string + + @connection_string.setter + def connection_string(self, connection_string): + """ + Sets the connection_string of this ExternalMacsConnectorSummary. + + :param connection_string: The connection_string of this ExternalMacsConnectorSummary. + :type: oci.database.models.DatabaseConnectionString + """ + self._connection_string = connection_string + + @property + def connection_credentials(self): + """ + **[Required]** Gets the connection_credentials of this ExternalMacsConnectorSummary. + + :return: The connection_credentials of this ExternalMacsConnectorSummary. + :rtype: oci.database.models.DatabaseConnectionCredentials + """ + return self._connection_credentials + + @connection_credentials.setter + def connection_credentials(self, connection_credentials): + """ + Sets the connection_credentials of this ExternalMacsConnectorSummary. + + :param connection_credentials: The connection_credentials of this ExternalMacsConnectorSummary. + :type: oci.database.models.DatabaseConnectionCredentials + """ + self._connection_credentials = connection_credentials + + @property + def connector_agent_id(self): + """ + **[Required]** Gets the connector_agent_id of this ExternalMacsConnectorSummary. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :return: The connector_agent_id of this ExternalMacsConnectorSummary. + :rtype: str + """ + return self._connector_agent_id + + @connector_agent_id.setter + def connector_agent_id(self, connector_agent_id): + """ + Sets the connector_agent_id of this ExternalMacsConnectorSummary. + The ID of the agent used for the + :func:`create_external_database_connector_details`. + + + :param connector_agent_id: The connector_agent_id of this ExternalMacsConnectorSummary. + :type: str + """ + self._connector_agent_id = connector_agent_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_non_container_database.py b/src/oci/database/models/external_non_container_database.py new file mode 100644 index 0000000000..bf925801d2 --- /dev/null +++ b/src/oci/database/models/external_non_container_database.py @@ -0,0 +1,650 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalNonContainerDatabase(object): + """ + an external Oracle non-container database. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabase. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabase. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalNonContainerDatabase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalNonContainerDatabase. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalNonContainerDatabase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalNonContainerDatabase. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalNonContainerDatabase. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalNonContainerDatabase. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalNonContainerDatabase. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalNonContainerDatabase. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalNonContainerDatabase. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalNonContainerDatabase. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalNonContainerDatabase. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalNonContainerDatabase. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalNonContainerDatabase. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalNonContainerDatabase. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalNonContainerDatabase. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalNonContainerDatabase. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalNonContainerDatabase. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalNonContainerDatabase. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalNonContainerDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalNonContainerDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalNonContainerDatabase. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalNonContainerDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalNonContainerDatabase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalNonContainerDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalNonContainerDatabase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalNonContainerDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalNonContainerDatabase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalNonContainerDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalNonContainerDatabase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalNonContainerDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalNonContainerDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalNonContainerDatabase. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalNonContainerDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalNonContainerDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalNonContainerDatabase. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalNonContainerDatabase. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalNonContainerDatabase. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalNonContainerDatabase. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalNonContainerDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalNonContainerDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalNonContainerDatabase. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalNonContainerDatabase. + The date and time the database was created. + + + :return: The time_created of this ExternalNonContainerDatabase. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalNonContainerDatabase. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalNonContainerDatabase. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalNonContainerDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalNonContainerDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalNonContainerDatabase. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalNonContainerDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalNonContainerDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalNonContainerDatabase. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalNonContainerDatabase. + The Oracle Database version. + + + :return: The database_version of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalNonContainerDatabase. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalNonContainerDatabase. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalNonContainerDatabase. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalNonContainerDatabase. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalNonContainerDatabase. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalNonContainerDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalNonContainerDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalNonContainerDatabase. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalNonContainerDatabase. + The character set of the external database. + + + :return: The character_set of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalNonContainerDatabase. + The character set of the external database. + + + :param character_set: The character_set of this ExternalNonContainerDatabase. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalNonContainerDatabase. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalNonContainerDatabase. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalNonContainerDatabase. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalNonContainerDatabase. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalNonContainerDatabase. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalNonContainerDatabase. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalNonContainerDatabase. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalNonContainerDatabase. + + :return: The database_management_config of this ExternalNonContainerDatabase. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalNonContainerDatabase. + + :param database_management_config: The database_management_config of this ExternalNonContainerDatabase. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_non_container_database_summary.py b/src/oci/database/models/external_non_container_database_summary.py new file mode 100644 index 0000000000..2fa79c8ee6 --- /dev/null +++ b/src/oci/database/models/external_non_container_database_summary.py @@ -0,0 +1,651 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalNonContainerDatabaseSummary(object): + """ + An Oracle Cloud Infrastructure external non-container database resource. This resource is used to manage a non-container + database located outside of Oracle Cloud. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalNonContainerDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalNonContainerDatabaseSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalNonContainerDatabaseSummary. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalNonContainerDatabaseSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalNonContainerDatabaseSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalNonContainerDatabaseSummary. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalNonContainerDatabaseSummary. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalNonContainerDatabaseSummary. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalNonContainerDatabaseSummary. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalNonContainerDatabaseSummary. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalNonContainerDatabaseSummary. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalNonContainerDatabaseSummary. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalNonContainerDatabaseSummary. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalNonContainerDatabaseSummary. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalNonContainerDatabaseSummary. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalNonContainerDatabaseSummary. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalNonContainerDatabaseSummary. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalNonContainerDatabaseSummary. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalNonContainerDatabaseSummary. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalNonContainerDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalNonContainerDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalNonContainerDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalNonContainerDatabaseSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalNonContainerDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalNonContainerDatabaseSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalNonContainerDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalNonContainerDatabaseSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalNonContainerDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalNonContainerDatabaseSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalNonContainerDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalNonContainerDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalNonContainerDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalNonContainerDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalNonContainerDatabaseSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalNonContainerDatabaseSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalNonContainerDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalNonContainerDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalNonContainerDatabaseSummary. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalNonContainerDatabaseSummary. + The date and time the database was created. + + + :return: The time_created of this ExternalNonContainerDatabaseSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalNonContainerDatabaseSummary. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalNonContainerDatabaseSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalNonContainerDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalNonContainerDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalNonContainerDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalNonContainerDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalNonContainerDatabaseSummary. + The Oracle Database version. + + + :return: The database_version of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalNonContainerDatabaseSummary. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalNonContainerDatabaseSummary. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalNonContainerDatabaseSummary. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalNonContainerDatabaseSummary. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalNonContainerDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalNonContainerDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalNonContainerDatabaseSummary. + The character set of the external database. + + + :return: The character_set of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalNonContainerDatabaseSummary. + The character set of the external database. + + + :param character_set: The character_set of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalNonContainerDatabaseSummary. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalNonContainerDatabaseSummary. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalNonContainerDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalNonContainerDatabaseSummary. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalNonContainerDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalNonContainerDatabaseSummary. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalNonContainerDatabaseSummary. + + :return: The database_management_config of this ExternalNonContainerDatabaseSummary. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalNonContainerDatabaseSummary. + + :param database_management_config: The database_management_config of this ExternalNonContainerDatabaseSummary. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_pluggable_database.py b/src/oci/database/models/external_pluggable_database.py new file mode 100644 index 0000000000..5b155e3537 --- /dev/null +++ b/src/oci/database/models/external_pluggable_database.py @@ -0,0 +1,726 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalPluggableDatabase(object): + """ + an external Oracle pluggable database. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabase. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabase. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabase. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabase. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalPluggableDatabase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param source_id: + The value to assign to the source_id property of this ExternalPluggableDatabase. + :type source_id: str + + :param external_container_database_id: + The value to assign to the external_container_database_id property of this ExternalPluggableDatabase. + :type external_container_database_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalPluggableDatabase. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalPluggableDatabase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalPluggableDatabase. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalPluggableDatabase. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalPluggableDatabase. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalPluggableDatabase. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalPluggableDatabase. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalPluggableDatabase. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalPluggableDatabase. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalPluggableDatabase. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalPluggableDatabase. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalPluggableDatabase. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalPluggableDatabase. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalPluggableDatabase. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalPluggableDatabase. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalPluggableDatabase. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalPluggableDatabase. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'source_id': 'str', + 'external_container_database_id': 'str', + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'source_id': 'sourceId', + 'external_container_database_id': 'externalContainerDatabaseId', + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._source_id = None + self._external_container_database_id = None + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def source_id(self): + """ + Gets the source_id of this ExternalPluggableDatabase. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The source_id of this ExternalPluggableDatabase. + :rtype: str + """ + return self._source_id + + @source_id.setter + def source_id(self, source_id): + """ + Sets the source_id of this ExternalPluggableDatabase. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param source_id: The source_id of this ExternalPluggableDatabase. + :type: str + """ + self._source_id = source_id + + @property + def external_container_database_id(self): + """ + **[Required]** Gets the external_container_database_id of this ExternalPluggableDatabase. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The external_container_database_id of this ExternalPluggableDatabase. + :rtype: str + """ + return self._external_container_database_id + + @external_container_database_id.setter + def external_container_database_id(self, external_container_database_id): + """ + Sets the external_container_database_id of this ExternalPluggableDatabase. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param external_container_database_id: The external_container_database_id of this ExternalPluggableDatabase. + :type: str + """ + self._external_container_database_id = external_container_database_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalPluggableDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalPluggableDatabase. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalPluggableDatabase. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalPluggableDatabase. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalPluggableDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalPluggableDatabase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalPluggableDatabase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalPluggableDatabase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalPluggableDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalPluggableDatabase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalPluggableDatabase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalPluggableDatabase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalPluggableDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalPluggableDatabase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalPluggableDatabase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalPluggableDatabase. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalPluggableDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalPluggableDatabase. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalPluggableDatabase. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalPluggableDatabase. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalPluggableDatabase. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalPluggableDatabase. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalPluggableDatabase. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalPluggableDatabase. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalPluggableDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalPluggableDatabase. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalPluggableDatabase. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalPluggableDatabase. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalPluggableDatabase. + The date and time the database was created. + + + :return: The time_created of this ExternalPluggableDatabase. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalPluggableDatabase. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalPluggableDatabase. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalPluggableDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalPluggableDatabase. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalPluggableDatabase. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalPluggableDatabase. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalPluggableDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalPluggableDatabase. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalPluggableDatabase. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalPluggableDatabase. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalPluggableDatabase. + The Oracle Database version. + + + :return: The database_version of this ExternalPluggableDatabase. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalPluggableDatabase. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalPluggableDatabase. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalPluggableDatabase. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalPluggableDatabase. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalPluggableDatabase. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalPluggableDatabase. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalPluggableDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalPluggableDatabase. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalPluggableDatabase. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalPluggableDatabase. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalPluggableDatabase. + The character set of the external database. + + + :return: The character_set of this ExternalPluggableDatabase. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalPluggableDatabase. + The character set of the external database. + + + :param character_set: The character_set of this ExternalPluggableDatabase. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalPluggableDatabase. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalPluggableDatabase. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalPluggableDatabase. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalPluggableDatabase. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalPluggableDatabase. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalPluggableDatabase. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalPluggableDatabase. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalPluggableDatabase. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalPluggableDatabase. + + :return: The database_management_config of this ExternalPluggableDatabase. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalPluggableDatabase. + + :param database_management_config: The database_management_config of this ExternalPluggableDatabase. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/external_pluggable_database_summary.py b/src/oci/database/models/external_pluggable_database_summary.py new file mode 100644 index 0000000000..50d2a6d11a --- /dev/null +++ b/src/oci/database/models/external_pluggable_database_summary.py @@ -0,0 +1,726 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ExternalPluggableDatabaseSummary(object): + """ + An Oracle Cloud Infrastructure resource that allows you to manage an external pluggable database. + """ + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "PROVISIONING" + LIFECYCLE_STATE_PROVISIONING = "PROVISIONING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "NOT_CONNECTED" + LIFECYCLE_STATE_NOT_CONNECTED = "NOT_CONNECTED" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "TERMINATING" + LIFECYCLE_STATE_TERMINATING = "TERMINATING" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "TERMINATED" + LIFECYCLE_STATE_TERMINATED = "TERMINATED" + + #: A constant which can be used with the lifecycle_state property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "STANDARD_EDITION" + DATABASE_EDITION_STANDARD_EDITION = "STANDARD_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION" + DATABASE_EDITION_ENTERPRISE_EDITION = "ENTERPRISE_EDITION" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_HIGH_PERFORMANCE = "ENTERPRISE_EDITION_HIGH_PERFORMANCE" + + #: A constant which can be used with the database_edition property of a ExternalPluggableDatabaseSummary. + #: This constant has a value of "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + DATABASE_EDITION_ENTERPRISE_EDITION_EXTREME_PERFORMANCE = "ENTERPRISE_EDITION_EXTREME_PERFORMANCE" + + def __init__(self, **kwargs): + """ + Initializes a new ExternalPluggableDatabaseSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param source_id: + The value to assign to the source_id property of this ExternalPluggableDatabaseSummary. + :type source_id: str + + :param external_container_database_id: + The value to assign to the external_container_database_id property of this ExternalPluggableDatabaseSummary. + :type external_container_database_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExternalPluggableDatabaseSummary. + :type compartment_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExternalPluggableDatabaseSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExternalPluggableDatabaseSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this ExternalPluggableDatabaseSummary. + :type display_name: str + + :param id: + The value to assign to the id property of this ExternalPluggableDatabaseSummary. + :type id: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExternalPluggableDatabaseSummary. + :type lifecycle_details: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExternalPluggableDatabaseSummary. + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param time_created: + The value to assign to the time_created property of this ExternalPluggableDatabaseSummary. + :type time_created: datetime + + :param db_unique_name: + The value to assign to the db_unique_name property of this ExternalPluggableDatabaseSummary. + :type db_unique_name: str + + :param db_id: + The value to assign to the db_id property of this ExternalPluggableDatabaseSummary. + :type db_id: str + + :param database_version: + The value to assign to the database_version property of this ExternalPluggableDatabaseSummary. + :type database_version: str + + :param database_edition: + The value to assign to the database_edition property of this ExternalPluggableDatabaseSummary. + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type database_edition: str + + :param time_zone: + The value to assign to the time_zone property of this ExternalPluggableDatabaseSummary. + :type time_zone: str + + :param character_set: + The value to assign to the character_set property of this ExternalPluggableDatabaseSummary. + :type character_set: str + + :param ncharacter_set: + The value to assign to the ncharacter_set property of this ExternalPluggableDatabaseSummary. + :type ncharacter_set: str + + :param db_packs: + The value to assign to the db_packs property of this ExternalPluggableDatabaseSummary. + :type db_packs: str + + :param database_management_config: + The value to assign to the database_management_config property of this ExternalPluggableDatabaseSummary. + :type database_management_config: oci.database.models.DatabaseManagementConfig + + """ + self.swagger_types = { + 'source_id': 'str', + 'external_container_database_id': 'str', + 'compartment_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'id': 'str', + 'lifecycle_details': 'str', + 'lifecycle_state': 'str', + 'time_created': 'datetime', + 'db_unique_name': 'str', + 'db_id': 'str', + 'database_version': 'str', + 'database_edition': 'str', + 'time_zone': 'str', + 'character_set': 'str', + 'ncharacter_set': 'str', + 'db_packs': 'str', + 'database_management_config': 'DatabaseManagementConfig' + } + + self.attribute_map = { + 'source_id': 'sourceId', + 'external_container_database_id': 'externalContainerDatabaseId', + 'compartment_id': 'compartmentId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'id': 'id', + 'lifecycle_details': 'lifecycleDetails', + 'lifecycle_state': 'lifecycleState', + 'time_created': 'timeCreated', + 'db_unique_name': 'dbUniqueName', + 'db_id': 'dbId', + 'database_version': 'databaseVersion', + 'database_edition': 'databaseEdition', + 'time_zone': 'timeZone', + 'character_set': 'characterSet', + 'ncharacter_set': 'ncharacterSet', + 'db_packs': 'dbPacks', + 'database_management_config': 'databaseManagementConfig' + } + + self._source_id = None + self._external_container_database_id = None + self._compartment_id = None + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._id = None + self._lifecycle_details = None + self._lifecycle_state = None + self._time_created = None + self._db_unique_name = None + self._db_id = None + self._database_version = None + self._database_edition = None + self._time_zone = None + self._character_set = None + self._ncharacter_set = None + self._db_packs = None + self._database_management_config = None + + @property + def source_id(self): + """ + Gets the source_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The source_id of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._source_id + + @source_id.setter + def source_id(self, source_id): + """ + Sets the source_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the the non-container database that was converted + to a pluggable database to create this resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param source_id: The source_id of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._source_id = source_id + + @property + def external_container_database_id(self): + """ + **[Required]** Gets the external_container_database_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The external_container_database_id of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._external_container_database_id + + @external_container_database_id.setter + def external_container_database_id(self, external_container_database_id): + """ + Sets the external_container_database_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the + :func:`create_external_container_database_details` that contains + the specified :func:`create_external_pluggable_database_details` resource. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param external_container_database_id: The external_container_database_id of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._external_container_database_id = external_container_database_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExternalPluggableDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ExternalPluggableDatabaseSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExternalPluggableDatabaseSummary. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ExternalPluggableDatabaseSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExternalPluggableDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this ExternalPluggableDatabaseSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this ExternalPluggableDatabaseSummary. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this ExternalPluggableDatabaseSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExternalPluggableDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExternalPluggableDatabaseSummary. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._display_name = display_name + + @property + def id(self): + """ + **[Required]** Gets the id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExternalPluggableDatabaseSummary. + The `OCID`__ of the Oracle Cloud Infrastructure external database resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._id = id + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExternalPluggableDatabaseSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExternalPluggableDatabaseSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExternalPluggableDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + Allowed values for this property are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExternalPluggableDatabaseSummary. + The current state of the Oracle Cloud Infrastructure external database resource. + + + :param lifecycle_state: The lifecycle_state of this ExternalPluggableDatabaseSummary. + :type: str + """ + allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ExternalPluggableDatabaseSummary. + The date and time the database was created. + + + :return: The time_created of this ExternalPluggableDatabaseSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExternalPluggableDatabaseSummary. + The date and time the database was created. + + + :param time_created: The time_created of this ExternalPluggableDatabaseSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def db_unique_name(self): + """ + Gets the db_unique_name of this ExternalPluggableDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :return: The db_unique_name of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._db_unique_name + + @db_unique_name.setter + def db_unique_name(self, db_unique_name): + """ + Sets the db_unique_name of this ExternalPluggableDatabaseSummary. + The `DB_UNIQUE_NAME` of the external database. + + + :param db_unique_name: The db_unique_name of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._db_unique_name = db_unique_name + + @property + def db_id(self): + """ + Gets the db_id of this ExternalPluggableDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :return: The db_id of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._db_id + + @db_id.setter + def db_id(self, db_id): + """ + Sets the db_id of this ExternalPluggableDatabaseSummary. + The Oracle Database ID, which identifies an Oracle Database located outside of Oracle Cloud. + + + :param db_id: The db_id of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._db_id = db_id + + @property + def database_version(self): + """ + Gets the database_version of this ExternalPluggableDatabaseSummary. + The Oracle Database version. + + + :return: The database_version of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._database_version + + @database_version.setter + def database_version(self, database_version): + """ + Sets the database_version of this ExternalPluggableDatabaseSummary. + The Oracle Database version. + + + :param database_version: The database_version of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._database_version = database_version + + @property + def database_edition(self): + """ + Gets the database_edition of this ExternalPluggableDatabaseSummary. + The Oracle Database edition. + + Allowed values for this property are: "STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The database_edition of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._database_edition + + @database_edition.setter + def database_edition(self, database_edition): + """ + Sets the database_edition of this ExternalPluggableDatabaseSummary. + The Oracle Database edition. + + + :param database_edition: The database_edition of this ExternalPluggableDatabaseSummary. + :type: str + """ + allowed_values = ["STANDARD_EDITION", "ENTERPRISE_EDITION", "ENTERPRISE_EDITION_HIGH_PERFORMANCE", "ENTERPRISE_EDITION_EXTREME_PERFORMANCE"] + if not value_allowed_none_or_none_sentinel(database_edition, allowed_values): + database_edition = 'UNKNOWN_ENUM_VALUE' + self._database_edition = database_edition + + @property + def time_zone(self): + """ + Gets the time_zone of this ExternalPluggableDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :return: The time_zone of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._time_zone + + @time_zone.setter + def time_zone(self, time_zone): + """ + Sets the time_zone of this ExternalPluggableDatabaseSummary. + The time zone of the external database. + It is a time zone offset (a character type in the format '[+|-]TZH:TZM') or a time zone region name, + depending on how the time zone value was specified when the database was created / last altered. + + + :param time_zone: The time_zone of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._time_zone = time_zone + + @property + def character_set(self): + """ + Gets the character_set of this ExternalPluggableDatabaseSummary. + The character set of the external database. + + + :return: The character_set of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._character_set + + @character_set.setter + def character_set(self, character_set): + """ + Sets the character_set of this ExternalPluggableDatabaseSummary. + The character set of the external database. + + + :param character_set: The character_set of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._character_set = character_set + + @property + def ncharacter_set(self): + """ + Gets the ncharacter_set of this ExternalPluggableDatabaseSummary. + The national character of the external database. + + + :return: The ncharacter_set of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._ncharacter_set + + @ncharacter_set.setter + def ncharacter_set(self, ncharacter_set): + """ + Sets the ncharacter_set of this ExternalPluggableDatabaseSummary. + The national character of the external database. + + + :param ncharacter_set: The ncharacter_set of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._ncharacter_set = ncharacter_set + + @property + def db_packs(self): + """ + Gets the db_packs of this ExternalPluggableDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :return: The db_packs of this ExternalPluggableDatabaseSummary. + :rtype: str + """ + return self._db_packs + + @db_packs.setter + def db_packs(self, db_packs): + """ + Sets the db_packs of this ExternalPluggableDatabaseSummary. + The database packs licensed for the external Oracle Database. + + + :param db_packs: The db_packs of this ExternalPluggableDatabaseSummary. + :type: str + """ + self._db_packs = db_packs + + @property + def database_management_config(self): + """ + Gets the database_management_config of this ExternalPluggableDatabaseSummary. + + :return: The database_management_config of this ExternalPluggableDatabaseSummary. + :rtype: oci.database.models.DatabaseManagementConfig + """ + return self._database_management_config + + @database_management_config.setter + def database_management_config(self, database_management_config): + """ + Sets the database_management_config of this ExternalPluggableDatabaseSummary. + + :param database_management_config: The database_management_config of this ExternalPluggableDatabaseSummary. + :type: oci.database.models.DatabaseManagementConfig + """ + self._database_management_config = database_management_config + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/maintenance_run.py b/src/oci/database/models/maintenance_run.py index 28d57cd0b3..1f06ce329a 100644 --- a/src/oci/database/models/maintenance_run.py +++ b/src/oci/database/models/maintenance_run.py @@ -521,9 +521,7 @@ def maintenance_type(self, maintenance_type): def patch_id(self): """ Gets the patch_id of this MaintenanceRun. - The `OCID`__ of the patch to be applied in the maintenance run. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + The unique identifier of the patch. The identifier string includes the patch type, the Oracle Database version, and the patch creation date (using the format YYMMDD). For example, the identifier `ru_patch_19.9.0.0_201030` is used for an RU patch for Oracle Database 19.9.0.0 that was released October 30, 2020. :return: The patch_id of this MaintenanceRun. @@ -535,9 +533,7 @@ def patch_id(self): def patch_id(self, patch_id): """ Sets the patch_id of this MaintenanceRun. - The `OCID`__ of the patch to be applied in the maintenance run. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + The unique identifier of the patch. The identifier string includes the patch type, the Oracle Database version, and the patch creation date (using the format YYMMDD). For example, the identifier `ru_patch_19.9.0.0_201030` is used for an RU patch for Oracle Database 19.9.0.0 that was released October 30, 2020. :param patch_id: The patch_id of this MaintenanceRun. diff --git a/src/oci/database/models/maintenance_run_summary.py b/src/oci/database/models/maintenance_run_summary.py index 1c61b93b43..f384381515 100644 --- a/src/oci/database/models/maintenance_run_summary.py +++ b/src/oci/database/models/maintenance_run_summary.py @@ -521,9 +521,7 @@ def maintenance_type(self, maintenance_type): def patch_id(self): """ Gets the patch_id of this MaintenanceRunSummary. - The `OCID`__ of the patch to be applied in the maintenance run. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + The unique identifier of the patch. The identifier string includes the patch type, the Oracle Database version, and the patch creation date (using the format YYMMDD). For example, the identifier `ru_patch_19.9.0.0_201030` is used for an RU patch for Oracle Database 19.9.0.0 that was released October 30, 2020. :return: The patch_id of this MaintenanceRunSummary. @@ -535,9 +533,7 @@ def patch_id(self): def patch_id(self, patch_id): """ Sets the patch_id of this MaintenanceRunSummary. - The `OCID`__ of the patch to be applied in the maintenance run. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + The unique identifier of the patch. The identifier string includes the patch type, the Oracle Database version, and the patch creation date (using the format YYMMDD). For example, the identifier `ru_patch_19.9.0.0_201030` is used for an RU patch for Oracle Database 19.9.0.0 that was released October 30, 2020. :param patch_id: The patch_id of this MaintenanceRunSummary. diff --git a/src/oci/database/models/update.py b/src/oci/database/models/update.py index 1c5680121d..0092e20df6 100644 --- a/src/oci/database/models/update.py +++ b/src/oci/database/models/update.py @@ -25,6 +25,10 @@ class Update(object): #: This constant has a value of "PRECHECK" LAST_ACTION_PRECHECK = "PRECHECK" + #: A constant which can be used with the last_action property of a Update. + #: This constant has a value of "ROLLBACK" + LAST_ACTION_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the available_actions property of a Update. #: This constant has a value of "ROLLING_APPLY" AVAILABLE_ACTIONS_ROLLING_APPLY = "ROLLING_APPLY" @@ -37,6 +41,10 @@ class Update(object): #: This constant has a value of "PRECHECK" AVAILABLE_ACTIONS_PRECHECK = "PRECHECK" + #: A constant which can be used with the available_actions property of a Update. + #: This constant has a value of "ROLLBACK" + AVAILABLE_ACTIONS_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the update_type property of a Update. #: This constant has a value of "GI_UPGRADE" UPDATE_TYPE_GI_UPGRADE = "GI_UPGRADE" @@ -45,6 +53,10 @@ class Update(object): #: This constant has a value of "GI_PATCH" UPDATE_TYPE_GI_PATCH = "GI_PATCH" + #: A constant which can be used with the update_type property of a Update. + #: This constant has a value of "OS_UPDATE" + UPDATE_TYPE_OS_UPDATE = "OS_UPDATE" + #: A constant which can be used with the lifecycle_state property of a Update. #: This constant has a value of "AVAILABLE" LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" @@ -76,19 +88,19 @@ def __init__(self, **kwargs): :param last_action: The value to assign to the last_action property of this Update. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type last_action: str :param available_actions: The value to assign to the available_actions property of this Update. - Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type available_actions: list[str] :param update_type: The value to assign to the update_type property of this Update. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_type: str @@ -203,7 +215,7 @@ def last_action(self): Gets the last_action of this Update. The update action. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -222,7 +234,7 @@ def last_action(self, last_action): :param last_action: The last_action of this Update. :type: str """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if not value_allowed_none_or_none_sentinel(last_action, allowed_values): last_action = 'UNKNOWN_ENUM_VALUE' self._last_action = last_action @@ -233,7 +245,7 @@ def available_actions(self): Gets the available_actions of this Update. The possible actions performed by the update operation on the infrastructure components. - Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -252,7 +264,7 @@ def available_actions(self, available_actions): :param available_actions: The available_actions of this Update. :type: list[str] """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if available_actions: available_actions[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in available_actions] self._available_actions = available_actions @@ -263,7 +275,7 @@ def update_type(self): **[Required]** Gets the update_type of this Update. The type of cloud VM cluster maintenance update. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -282,7 +294,7 @@ def update_type(self, update_type): :param update_type: The update_type of this Update. :type: str """ - allowed_values = ["GI_UPGRADE", "GI_PATCH"] + allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] if not value_allowed_none_or_none_sentinel(update_type, allowed_values): update_type = 'UNKNOWN_ENUM_VALUE' self._update_type = update_type diff --git a/src/oci/database/models/update_details.py b/src/oci/database/models/update_details.py index e51c1daaab..d88a5fafae 100644 --- a/src/oci/database/models/update_details.py +++ b/src/oci/database/models/update_details.py @@ -25,6 +25,10 @@ class UpdateDetails(object): #: This constant has a value of "PRECHECK" UPDATE_ACTION_PRECHECK = "PRECHECK" + #: A constant which can be used with the update_action property of a UpdateDetails. + #: This constant has a value of "ROLLBACK" + UPDATE_ACTION_ROLLBACK = "ROLLBACK" + def __init__(self, **kwargs): """ Initializes a new UpdateDetails object with values from keyword arguments. @@ -36,7 +40,7 @@ def __init__(self, **kwargs): :param update_action: The value to assign to the update_action property of this UpdateDetails. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK" + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK" :type update_action: str """ @@ -87,7 +91,7 @@ def update_action(self): Gets the update_action of this UpdateDetails. The update action. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK" + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK" :return: The update_action of this UpdateDetails. @@ -105,7 +109,7 @@ def update_action(self, update_action): :param update_action: The update_action of this UpdateDetails. :type: str """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if not value_allowed_none_or_none_sentinel(update_action, allowed_values): raise ValueError( "Invalid value for `update_action`, must be None or one of {0}" diff --git a/src/oci/database/models/update_external_container_database_details.py b/src/oci/database/models/update_external_container_database_details.py new file mode 100644 index 0000000000..0ae665224a --- /dev/null +++ b/src/oci/database/models/update_external_container_database_details.py @@ -0,0 +1,148 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalContainerDatabaseDetails(object): + """ + Details for updating an external container database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalContainerDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param display_name: + The value to assign to the display_name property of this UpdateExternalContainerDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalContainerDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalContainerDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this UpdateExternalContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this UpdateExternalContainerDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateExternalContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this UpdateExternalContainerDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExternalContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateExternalContainerDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExternalContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateExternalContainerDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExternalContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateExternalContainerDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateExternalContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateExternalContainerDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_external_database_connector_details.py b/src/oci/database/models/update_external_database_connector_details.py new file mode 100644 index 0000000000..d9aa25cb59 --- /dev/null +++ b/src/oci/database/models/update_external_database_connector_details.py @@ -0,0 +1,213 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalDatabaseConnectorDetails(object): + """ + Details for updating an external database connector. + """ + + #: A constant which can be used with the connector_type property of a UpdateExternalDatabaseConnectorDetails. + #: This constant has a value of "MACS" + CONNECTOR_TYPE_MACS = "MACS" + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalDatabaseConnectorDetails object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.database.models.UpdateExternalMacsConnectorDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalDatabaseConnectorDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalDatabaseConnectorDetails. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this UpdateExternalDatabaseConnectorDetails. + :type display_name: str + + :param connector_type: + The value to assign to the connector_type property of this UpdateExternalDatabaseConnectorDetails. + Allowed values for this property are: "MACS" + :type connector_type: str + + """ + self.swagger_types = { + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'connector_type': 'str' + } + + self.attribute_map = { + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'connector_type': 'connectorType' + } + + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._connector_type = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['connectorType'] + + if type == 'MACS': + return 'UpdateExternalMacsConnectorDetails' + else: + return 'UpdateExternalDatabaseConnectorDetails' + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExternalDatabaseConnectorDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateExternalDatabaseConnectorDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExternalDatabaseConnectorDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateExternalDatabaseConnectorDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExternalDatabaseConnectorDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateExternalDatabaseConnectorDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateExternalDatabaseConnectorDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateExternalDatabaseConnectorDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def display_name(self): + """ + Gets the display_name of this UpdateExternalDatabaseConnectorDetails. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :return: The display_name of this UpdateExternalDatabaseConnectorDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateExternalDatabaseConnectorDetails. + The user-friendly name for the + :func:`create_external_database_connector_details`. + The name does not have to be unique. + + + :param display_name: The display_name of this UpdateExternalDatabaseConnectorDetails. + :type: str + """ + self._display_name = display_name + + @property + def connector_type(self): + """ + Gets the connector_type of this UpdateExternalDatabaseConnectorDetails. + The type of connector used by the external database resource. + + Allowed values for this property are: "MACS" + + + :return: The connector_type of this UpdateExternalDatabaseConnectorDetails. + :rtype: str + """ + return self._connector_type + + @connector_type.setter + def connector_type(self, connector_type): + """ + Sets the connector_type of this UpdateExternalDatabaseConnectorDetails. + The type of connector used by the external database resource. + + + :param connector_type: The connector_type of this UpdateExternalDatabaseConnectorDetails. + :type: str + """ + allowed_values = ["MACS"] + if not value_allowed_none_or_none_sentinel(connector_type, allowed_values): + raise ValueError( + "Invalid value for `connector_type`, must be None or one of {0}" + .format(allowed_values) + ) + self._connector_type = connector_type + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_external_database_details_base.py b/src/oci/database/models/update_external_database_details_base.py new file mode 100644 index 0000000000..82ca463179 --- /dev/null +++ b/src/oci/database/models/update_external_database_details_base.py @@ -0,0 +1,148 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalDatabaseDetailsBase(object): + """ + Details for updating an external database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalDatabaseDetailsBase object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param display_name: + The value to assign to the display_name property of this UpdateExternalDatabaseDetailsBase. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalDatabaseDetailsBase. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalDatabaseDetailsBase. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this UpdateExternalDatabaseDetailsBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this UpdateExternalDatabaseDetailsBase. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateExternalDatabaseDetailsBase. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this UpdateExternalDatabaseDetailsBase. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExternalDatabaseDetailsBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateExternalDatabaseDetailsBase. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExternalDatabaseDetailsBase. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateExternalDatabaseDetailsBase. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExternalDatabaseDetailsBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateExternalDatabaseDetailsBase. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateExternalDatabaseDetailsBase. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateExternalDatabaseDetailsBase. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_external_macs_connector_details.py b/src/oci/database/models/update_external_macs_connector_details.py new file mode 100644 index 0000000000..4d93b46750 --- /dev/null +++ b/src/oci/database/models/update_external_macs_connector_details.py @@ -0,0 +1,126 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .update_external_database_connector_details import UpdateExternalDatabaseConnectorDetails +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalMacsConnectorDetails(UpdateExternalDatabaseConnectorDetails): + """ + Details for updating an external `Management Agent cloud service (MACS)`__ database connection. + + __ https://docs.cloud.oracle.com/iaas/management-agents/index.html + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalMacsConnectorDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database.models.UpdateExternalMacsConnectorDetails.connector_type` attribute + of this class is ``MACS`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalMacsConnectorDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalMacsConnectorDetails. + :type defined_tags: dict(str, dict(str, object)) + + :param display_name: + The value to assign to the display_name property of this UpdateExternalMacsConnectorDetails. + :type display_name: str + + :param connector_type: + The value to assign to the connector_type property of this UpdateExternalMacsConnectorDetails. + Allowed values for this property are: "MACS" + :type connector_type: str + + :param connection_string: + The value to assign to the connection_string property of this UpdateExternalMacsConnectorDetails. + :type connection_string: oci.database.models.DatabaseConnectionString + + :param connection_credentials: + The value to assign to the connection_credentials property of this UpdateExternalMacsConnectorDetails. + :type connection_credentials: oci.database.models.DatabaseConnectionCredentials + + """ + self.swagger_types = { + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'display_name': 'str', + 'connector_type': 'str', + 'connection_string': 'DatabaseConnectionString', + 'connection_credentials': 'DatabaseConnectionCredentials' + } + + self.attribute_map = { + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'display_name': 'displayName', + 'connector_type': 'connectorType', + 'connection_string': 'connectionString', + 'connection_credentials': 'connectionCredentials' + } + + self._freeform_tags = None + self._defined_tags = None + self._display_name = None + self._connector_type = None + self._connection_string = None + self._connection_credentials = None + self._connector_type = 'MACS' + + @property + def connection_string(self): + """ + Gets the connection_string of this UpdateExternalMacsConnectorDetails. + + :return: The connection_string of this UpdateExternalMacsConnectorDetails. + :rtype: oci.database.models.DatabaseConnectionString + """ + return self._connection_string + + @connection_string.setter + def connection_string(self, connection_string): + """ + Sets the connection_string of this UpdateExternalMacsConnectorDetails. + + :param connection_string: The connection_string of this UpdateExternalMacsConnectorDetails. + :type: oci.database.models.DatabaseConnectionString + """ + self._connection_string = connection_string + + @property + def connection_credentials(self): + """ + Gets the connection_credentials of this UpdateExternalMacsConnectorDetails. + + :return: The connection_credentials of this UpdateExternalMacsConnectorDetails. + :rtype: oci.database.models.DatabaseConnectionCredentials + """ + return self._connection_credentials + + @connection_credentials.setter + def connection_credentials(self, connection_credentials): + """ + Sets the connection_credentials of this UpdateExternalMacsConnectorDetails. + + :param connection_credentials: The connection_credentials of this UpdateExternalMacsConnectorDetails. + :type: oci.database.models.DatabaseConnectionCredentials + """ + self._connection_credentials = connection_credentials + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_external_non_container_database_details.py b/src/oci/database/models/update_external_non_container_database_details.py new file mode 100644 index 0000000000..87484f52b3 --- /dev/null +++ b/src/oci/database/models/update_external_non_container_database_details.py @@ -0,0 +1,148 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalNonContainerDatabaseDetails(object): + """ + Details for updating an external non-container database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalNonContainerDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param display_name: + The value to assign to the display_name property of this UpdateExternalNonContainerDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalNonContainerDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalNonContainerDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this UpdateExternalNonContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this UpdateExternalNonContainerDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateExternalNonContainerDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this UpdateExternalNonContainerDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExternalNonContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateExternalNonContainerDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExternalNonContainerDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateExternalNonContainerDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExternalNonContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateExternalNonContainerDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateExternalNonContainerDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateExternalNonContainerDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_external_pluggable_database_details.py b/src/oci/database/models/update_external_pluggable_database_details.py new file mode 100644 index 0000000000..6e5a52ffab --- /dev/null +++ b/src/oci/database/models/update_external_pluggable_database_details.py @@ -0,0 +1,148 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateExternalPluggableDatabaseDetails(object): + """ + Details for updating an external pluggable database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExternalPluggableDatabaseDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param display_name: + The value to assign to the display_name property of this UpdateExternalPluggableDatabaseDetails. + :type display_name: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExternalPluggableDatabaseDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExternalPluggableDatabaseDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this UpdateExternalPluggableDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :return: The display_name of this UpdateExternalPluggableDatabaseDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateExternalPluggableDatabaseDetails. + The user-friendly name for the external database. The name does not have to be unique. + + + :param display_name: The display_name of this UpdateExternalPluggableDatabaseDetails. + :type: str + """ + self._display_name = display_name + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExternalPluggableDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateExternalPluggableDatabaseDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExternalPluggableDatabaseDetails. + Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateExternalPluggableDatabaseDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExternalPluggableDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateExternalPluggableDatabaseDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateExternalPluggableDatabaseDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateExternalPluggableDatabaseDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/database/models/update_history_entry.py b/src/oci/database/models/update_history_entry.py index 02581e89ac..28e202fd09 100644 --- a/src/oci/database/models/update_history_entry.py +++ b/src/oci/database/models/update_history_entry.py @@ -25,6 +25,10 @@ class UpdateHistoryEntry(object): #: This constant has a value of "PRECHECK" UPDATE_ACTION_PRECHECK = "PRECHECK" + #: A constant which can be used with the update_action property of a UpdateHistoryEntry. + #: This constant has a value of "ROLLBACK" + UPDATE_ACTION_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the update_type property of a UpdateHistoryEntry. #: This constant has a value of "GI_UPGRADE" UPDATE_TYPE_GI_UPGRADE = "GI_UPGRADE" @@ -33,6 +37,10 @@ class UpdateHistoryEntry(object): #: This constant has a value of "GI_PATCH" UPDATE_TYPE_GI_PATCH = "GI_PATCH" + #: A constant which can be used with the update_type property of a UpdateHistoryEntry. + #: This constant has a value of "OS_UPDATE" + UPDATE_TYPE_OS_UPDATE = "OS_UPDATE" + #: A constant which can be used with the lifecycle_state property of a UpdateHistoryEntry. #: This constant has a value of "IN_PROGRESS" LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" @@ -60,13 +68,13 @@ def __init__(self, **kwargs): :param update_action: The value to assign to the update_action property of this UpdateHistoryEntry. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_action: str :param update_type: The value to assign to the update_type property of this UpdateHistoryEntry. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_type: str @@ -182,7 +190,7 @@ def update_action(self): Gets the update_action of this UpdateHistoryEntry. The update action. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -201,7 +209,7 @@ def update_action(self, update_action): :param update_action: The update_action of this UpdateHistoryEntry. :type: str """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if not value_allowed_none_or_none_sentinel(update_action, allowed_values): update_action = 'UNKNOWN_ENUM_VALUE' self._update_action = update_action @@ -212,7 +220,7 @@ def update_type(self): **[Required]** Gets the update_type of this UpdateHistoryEntry. The type of cloud VM cluster maintenance update. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -231,7 +239,7 @@ def update_type(self, update_type): :param update_type: The update_type of this UpdateHistoryEntry. :type: str """ - allowed_values = ["GI_UPGRADE", "GI_PATCH"] + allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] if not value_allowed_none_or_none_sentinel(update_type, allowed_values): update_type = 'UNKNOWN_ENUM_VALUE' self._update_type = update_type diff --git a/src/oci/database/models/update_history_entry_summary.py b/src/oci/database/models/update_history_entry_summary.py index 935caecb44..0a9dc4fc7f 100644 --- a/src/oci/database/models/update_history_entry_summary.py +++ b/src/oci/database/models/update_history_entry_summary.py @@ -25,6 +25,10 @@ class UpdateHistoryEntrySummary(object): #: This constant has a value of "PRECHECK" UPDATE_ACTION_PRECHECK = "PRECHECK" + #: A constant which can be used with the update_action property of a UpdateHistoryEntrySummary. + #: This constant has a value of "ROLLBACK" + UPDATE_ACTION_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the update_type property of a UpdateHistoryEntrySummary. #: This constant has a value of "GI_UPGRADE" UPDATE_TYPE_GI_UPGRADE = "GI_UPGRADE" @@ -33,6 +37,10 @@ class UpdateHistoryEntrySummary(object): #: This constant has a value of "GI_PATCH" UPDATE_TYPE_GI_PATCH = "GI_PATCH" + #: A constant which can be used with the update_type property of a UpdateHistoryEntrySummary. + #: This constant has a value of "OS_UPDATE" + UPDATE_TYPE_OS_UPDATE = "OS_UPDATE" + #: A constant which can be used with the lifecycle_state property of a UpdateHistoryEntrySummary. #: This constant has a value of "IN_PROGRESS" LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" @@ -60,13 +68,13 @@ def __init__(self, **kwargs): :param update_action: The value to assign to the update_action property of this UpdateHistoryEntrySummary. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_action: str :param update_type: The value to assign to the update_type property of this UpdateHistoryEntrySummary. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_type: str @@ -182,7 +190,7 @@ def update_action(self): Gets the update_action of this UpdateHistoryEntrySummary. The update action. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -201,7 +209,7 @@ def update_action(self, update_action): :param update_action: The update_action of this UpdateHistoryEntrySummary. :type: str """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if not value_allowed_none_or_none_sentinel(update_action, allowed_values): update_action = 'UNKNOWN_ENUM_VALUE' self._update_action = update_action @@ -212,7 +220,7 @@ def update_type(self): **[Required]** Gets the update_type of this UpdateHistoryEntrySummary. The type of cloud VM cluster maintenance update. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -231,7 +239,7 @@ def update_type(self, update_type): :param update_type: The update_type of this UpdateHistoryEntrySummary. :type: str """ - allowed_values = ["GI_UPGRADE", "GI_PATCH"] + allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] if not value_allowed_none_or_none_sentinel(update_type, allowed_values): update_type = 'UNKNOWN_ENUM_VALUE' self._update_type = update_type diff --git a/src/oci/database/models/update_summary.py b/src/oci/database/models/update_summary.py index f8a8d114ab..ca5fcbdce3 100644 --- a/src/oci/database/models/update_summary.py +++ b/src/oci/database/models/update_summary.py @@ -31,6 +31,10 @@ class UpdateSummary(object): #: This constant has a value of "PRECHECK" LAST_ACTION_PRECHECK = "PRECHECK" + #: A constant which can be used with the last_action property of a UpdateSummary. + #: This constant has a value of "ROLLBACK" + LAST_ACTION_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the available_actions property of a UpdateSummary. #: This constant has a value of "ROLLING_APPLY" AVAILABLE_ACTIONS_ROLLING_APPLY = "ROLLING_APPLY" @@ -43,6 +47,10 @@ class UpdateSummary(object): #: This constant has a value of "PRECHECK" AVAILABLE_ACTIONS_PRECHECK = "PRECHECK" + #: A constant which can be used with the available_actions property of a UpdateSummary. + #: This constant has a value of "ROLLBACK" + AVAILABLE_ACTIONS_ROLLBACK = "ROLLBACK" + #: A constant which can be used with the update_type property of a UpdateSummary. #: This constant has a value of "GI_UPGRADE" UPDATE_TYPE_GI_UPGRADE = "GI_UPGRADE" @@ -51,6 +59,10 @@ class UpdateSummary(object): #: This constant has a value of "GI_PATCH" UPDATE_TYPE_GI_PATCH = "GI_PATCH" + #: A constant which can be used with the update_type property of a UpdateSummary. + #: This constant has a value of "OS_UPDATE" + UPDATE_TYPE_OS_UPDATE = "OS_UPDATE" + #: A constant which can be used with the lifecycle_state property of a UpdateSummary. #: This constant has a value of "AVAILABLE" LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" @@ -82,19 +94,19 @@ def __init__(self, **kwargs): :param last_action: The value to assign to the last_action property of this UpdateSummary. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type last_action: str :param available_actions: The value to assign to the available_actions property of this UpdateSummary. - Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type available_actions: list[str] :param update_type: The value to assign to the update_type property of this UpdateSummary. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type update_type: str @@ -209,7 +221,7 @@ def last_action(self): Gets the last_action of this UpdateSummary. The update action. - Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -228,7 +240,7 @@ def last_action(self, last_action): :param last_action: The last_action of this UpdateSummary. :type: str """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if not value_allowed_none_or_none_sentinel(last_action, allowed_values): last_action = 'UNKNOWN_ENUM_VALUE' self._last_action = last_action @@ -239,7 +251,7 @@ def available_actions(self): Gets the available_actions of this UpdateSummary. The possible actions performed by the update operation on the infrastructure components. - Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -258,7 +270,7 @@ def available_actions(self, available_actions): :param available_actions: The available_actions of this UpdateSummary. :type: list[str] """ - allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK"] + allowed_values = ["ROLLING_APPLY", "NON_ROLLING_APPLY", "PRECHECK", "ROLLBACK"] if available_actions: available_actions[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in available_actions] self._available_actions = available_actions @@ -269,7 +281,7 @@ def update_type(self): **[Required]** Gets the update_type of this UpdateSummary. The type of cloud VM cluster maintenance update. - Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -288,7 +300,7 @@ def update_type(self, update_type): :param update_type: The update_type of this UpdateSummary. :type: str """ - allowed_values = ["GI_UPGRADE", "GI_PATCH"] + allowed_values = ["GI_UPGRADE", "GI_PATCH", "OS_UPDATE"] if not value_allowed_none_or_none_sentinel(update_type, allowed_values): update_type = 'UNKNOWN_ENUM_VALUE' self._update_type = update_type diff --git a/src/oci/object_storage/models/__init__.py b/src/oci/object_storage/models/__init__.py index e4a435fc81..58e732f61c 100644 --- a/src/oci/object_storage/models/__init__.py +++ b/src/oci/object_storage/models/__init__.py @@ -42,6 +42,7 @@ from .sse_customer_key_details import SSECustomerKeyDetails from .update_bucket_details import UpdateBucketDetails from .update_namespace_metadata_details import UpdateNamespaceMetadataDetails +from .update_object_storage_tier_details import UpdateObjectStorageTierDetails from .update_retention_rule_details import UpdateRetentionRuleDetails from .work_request import WorkRequest from .work_request_error import WorkRequestError @@ -89,6 +90,7 @@ "SSECustomerKeyDetails": SSECustomerKeyDetails, "UpdateBucketDetails": UpdateBucketDetails, "UpdateNamespaceMetadataDetails": UpdateNamespaceMetadataDetails, + "UpdateObjectStorageTierDetails": UpdateObjectStorageTierDetails, "UpdateRetentionRuleDetails": UpdateRetentionRuleDetails, "WorkRequest": WorkRequest, "WorkRequestError": WorkRequestError, diff --git a/src/oci/object_storage/models/bucket.py b/src/oci/object_storage/models/bucket.py index 67fb7e6518..f47a8138cd 100644 --- a/src/oci/object_storage/models/bucket.py +++ b/src/oci/object_storage/models/bucket.py @@ -217,7 +217,7 @@ def __init__(self, **kwargs): def namespace(self): """ **[Required]** Gets the namespace of this Bucket. - The Object Storage namespace in which the bucket lives. + The Object Storage namespace in which the bucket resides. :return: The namespace of this Bucket. @@ -229,7 +229,7 @@ def namespace(self): def namespace(self, namespace): """ Sets the namespace of this Bucket. - The Object Storage namespace in which the bucket lives. + The Object Storage namespace in which the bucket resides. :param namespace: The namespace of this Bucket. @@ -433,10 +433,10 @@ def public_access_type(self, public_access_type): def storage_tier(self): """ Gets the storage_tier of this Bucket. - The storage tier type assigned to the bucket. A bucket is set to 'Standard' tier by default, which means - objects uploaded or copied to the bucket will be in the standard storage tier. When the 'Archive' tier type + The storage tier type assigned to the bucket. A bucket is set to `Standard` tier by default, which means + objects uploaded or copied to the bucket will be in the standard storage tier. When the `Archive` tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. - The 'storageTier' property is immutable after bucket is created. + The `storageTier` property is immutable after bucket is created. Allowed values for this property are: "Standard", "Archive", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -451,10 +451,10 @@ def storage_tier(self): def storage_tier(self, storage_tier): """ Sets the storage_tier of this Bucket. - The storage tier type assigned to the bucket. A bucket is set to 'Standard' tier by default, which means - objects uploaded or copied to the bucket will be in the standard storage tier. When the 'Archive' tier type + The storage tier type assigned to the bucket. A bucket is set to `Standard` tier by default, which means + objects uploaded or copied to the bucket will be in the standard storage tier. When the `Archive` tier type is set explicitly for a bucket, objects uploaded or copied to the bucket will be stored in archive storage. - The 'storageTier' property is immutable after bucket is created. + The `storageTier` property is immutable after bucket is created. :param storage_tier: The storage_tier of this Bucket. diff --git a/src/oci/object_storage/models/copy_object_details.py b/src/oci/object_storage/models/copy_object_details.py index 7bd672e041..656bb8af52 100644 --- a/src/oci/object_storage/models/copy_object_details.py +++ b/src/oci/object_storage/models/copy_object_details.py @@ -19,6 +19,18 @@ class CopyObjectDetails(object): __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ + #: A constant which can be used with the destination_object_storage_tier property of a CopyObjectDetails. + #: This constant has a value of "Standard" + DESTINATION_OBJECT_STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the destination_object_storage_tier property of a CopyObjectDetails. + #: This constant has a value of "InfrequentAccess" + DESTINATION_OBJECT_STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the destination_object_storage_tier property of a CopyObjectDetails. + #: This constant has a value of "Archive" + DESTINATION_OBJECT_STORAGE_TIER_ARCHIVE = "Archive" + def __init__(self, **kwargs): """ Initializes a new CopyObjectDetails object with values from keyword arguments. @@ -64,6 +76,11 @@ def __init__(self, **kwargs): The value to assign to the destination_object_metadata property of this CopyObjectDetails. :type destination_object_metadata: dict(str, str) + :param destination_object_storage_tier: + The value to assign to the destination_object_storage_tier property of this CopyObjectDetails. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + :type destination_object_storage_tier: str + """ self.swagger_types = { 'source_object_name': 'str', @@ -75,7 +92,8 @@ def __init__(self, **kwargs): 'destination_object_name': 'str', 'destination_object_if_match_e_tag': 'str', 'destination_object_if_none_match_e_tag': 'str', - 'destination_object_metadata': 'dict(str, str)' + 'destination_object_metadata': 'dict(str, str)', + 'destination_object_storage_tier': 'str' } self.attribute_map = { @@ -88,7 +106,8 @@ def __init__(self, **kwargs): 'destination_object_name': 'destinationObjectName', 'destination_object_if_match_e_tag': 'destinationObjectIfMatchETag', 'destination_object_if_none_match_e_tag': 'destinationObjectIfNoneMatchETag', - 'destination_object_metadata': 'destinationObjectMetadata' + 'destination_object_metadata': 'destinationObjectMetadata', + 'destination_object_storage_tier': 'destinationObjectStorageTier' } self._source_object_name = None @@ -101,6 +120,7 @@ def __init__(self, **kwargs): self._destination_object_if_match_e_tag = None self._destination_object_if_none_match_e_tag = None self._destination_object_metadata = None + self._destination_object_storage_tier = None @property def source_object_name(self): @@ -252,7 +272,7 @@ def destination_bucket(self, destination_bucket): def destination_object_name(self): """ **[Required]** Gets the destination_object_name of this CopyObjectDetails. - The name of the destination object resulting from the copy operation. + The name of the destination object resulting from the copy operation. Avoid entering confidential information. :return: The destination_object_name of this CopyObjectDetails. @@ -264,7 +284,7 @@ def destination_object_name(self): def destination_object_name(self, destination_object_name): """ Sets the destination_object_name of this CopyObjectDetails. - The name of the destination object resulting from the copy operation. + The name of the destination object resulting from the copy operation. Avoid entering confidential information. :param destination_object_name: The destination_object_name of this CopyObjectDetails. @@ -356,6 +376,40 @@ def destination_object_metadata(self, destination_object_metadata): """ self._destination_object_metadata = destination_object_metadata + @property + def destination_object_storage_tier(self): + """ + Gets the destination_object_storage_tier of this CopyObjectDetails. + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + + + :return: The destination_object_storage_tier of this CopyObjectDetails. + :rtype: str + """ + return self._destination_object_storage_tier + + @destination_object_storage_tier.setter + def destination_object_storage_tier(self, destination_object_storage_tier): + """ + Sets the destination_object_storage_tier of this CopyObjectDetails. + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + + :param destination_object_storage_tier: The destination_object_storage_tier of this CopyObjectDetails. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(destination_object_storage_tier, allowed_values): + raise ValueError( + "Invalid value for `destination_object_storage_tier`, must be None or one of {0}" + .format(allowed_values) + ) + self._destination_object_storage_tier = destination_object_storage_tier + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/object_storage/models/create_multipart_upload_details.py b/src/oci/object_storage/models/create_multipart_upload_details.py index 845f81f049..3c6d0d39a4 100644 --- a/src/oci/object_storage/models/create_multipart_upload_details.py +++ b/src/oci/object_storage/models/create_multipart_upload_details.py @@ -17,6 +17,18 @@ class CreateMultipartUploadDetails(object): __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ + #: A constant which can be used with the storage_tier property of a CreateMultipartUploadDetails. + #: This constant has a value of "Standard" + STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the storage_tier property of a CreateMultipartUploadDetails. + #: This constant has a value of "InfrequentAccess" + STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the storage_tier property of a CreateMultipartUploadDetails. + #: This constant has a value of "Archive" + STORAGE_TIER_ARCHIVE = "Archive" + def __init__(self, **kwargs): """ Initializes a new CreateMultipartUploadDetails object with values from keyword arguments. @@ -46,6 +58,11 @@ def __init__(self, **kwargs): The value to assign to the cache_control property of this CreateMultipartUploadDetails. :type cache_control: str + :param storage_tier: + The value to assign to the storage_tier property of this CreateMultipartUploadDetails. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + :type storage_tier: str + :param metadata: The value to assign to the metadata property of this CreateMultipartUploadDetails. :type metadata: dict(str, str) @@ -58,6 +75,7 @@ def __init__(self, **kwargs): 'content_encoding': 'str', 'content_disposition': 'str', 'cache_control': 'str', + 'storage_tier': 'str', 'metadata': 'dict(str, str)' } @@ -68,6 +86,7 @@ def __init__(self, **kwargs): 'content_encoding': 'contentEncoding', 'content_disposition': 'contentDisposition', 'cache_control': 'cacheControl', + 'storage_tier': 'storageTier', 'metadata': 'metadata' } @@ -77,6 +96,7 @@ def __init__(self, **kwargs): self._content_encoding = None self._content_disposition = None self._cache_control = None + self._storage_tier = None self._metadata = None @property @@ -257,6 +277,40 @@ def cache_control(self, cache_control): """ self._cache_control = cache_control + @property + def storage_tier(self): + """ + Gets the storage_tier of this CreateMultipartUploadDetails. + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + + + :return: The storage_tier of this CreateMultipartUploadDetails. + :rtype: str + """ + return self._storage_tier + + @storage_tier.setter + def storage_tier(self, storage_tier): + """ + Sets the storage_tier of this CreateMultipartUploadDetails. + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + + :param storage_tier: The storage_tier of this CreateMultipartUploadDetails. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(storage_tier, allowed_values): + raise ValueError( + "Invalid value for `storage_tier`, must be None or one of {0}" + .format(allowed_values) + ) + self._storage_tier = storage_tier + @property def metadata(self): """ diff --git a/src/oci/object_storage/models/create_preauthenticated_request_details.py b/src/oci/object_storage/models/create_preauthenticated_request_details.py index 3abbacfcd1..6b19b0d1a3 100644 --- a/src/oci/object_storage/models/create_preauthenticated_request_details.py +++ b/src/oci/object_storage/models/create_preauthenticated_request_details.py @@ -76,6 +76,7 @@ def name(self): """ **[Required]** Gets the name of this CreatePreauthenticatedRequestDetails. A user-specified name for the pre-authenticated request. Names can be helpful in managing pre-authenticated requests. + Avoid entering confidential information. :return: The name of this CreatePreauthenticatedRequestDetails. @@ -88,6 +89,7 @@ def name(self, name): """ Sets the name of this CreatePreauthenticatedRequestDetails. A user-specified name for the pre-authenticated request. Names can be helpful in managing pre-authenticated requests. + Avoid entering confidential information. :param name: The name of this CreatePreauthenticatedRequestDetails. diff --git a/src/oci/object_storage/models/create_replication_policy_details.py b/src/oci/object_storage/models/create_replication_policy_details.py index ab05beb5e6..d0701bf3f7 100644 --- a/src/oci/object_storage/models/create_replication_policy_details.py +++ b/src/oci/object_storage/models/create_replication_policy_details.py @@ -51,7 +51,7 @@ def __init__(self, **kwargs): def name(self): """ **[Required]** Gets the name of this CreateReplicationPolicyDetails. - The name of the policy. + The name of the policy. Avoid entering confidential information. :return: The name of this CreateReplicationPolicyDetails. @@ -63,7 +63,7 @@ def name(self): def name(self, name): """ Sets the name of this CreateReplicationPolicyDetails. - The name of the policy. + The name of the policy. Avoid entering confidential information. :param name: The name of this CreateReplicationPolicyDetails. diff --git a/src/oci/object_storage/models/create_retention_rule_details.py b/src/oci/object_storage/models/create_retention_rule_details.py index 48832bf5fa..347c37b581 100644 --- a/src/oci/object_storage/models/create_retention_rule_details.py +++ b/src/oci/object_storage/models/create_retention_rule_details.py @@ -52,6 +52,7 @@ def display_name(self): """ Gets the display_name of this CreateRetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :return: The display_name of this CreateRetentionRuleDetails. @@ -64,6 +65,7 @@ def display_name(self, display_name): """ Sets the display_name of this CreateRetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :param display_name: The display_name of this CreateRetentionRuleDetails. diff --git a/src/oci/object_storage/models/list_objects.py b/src/oci/object_storage/models/list_objects.py index 88e7834ced..d4b46b9e52 100644 --- a/src/oci/object_storage/models/list_objects.py +++ b/src/oci/object_storage/models/list_objects.py @@ -103,7 +103,7 @@ def prefixes(self, prefixes): def next_start_with(self): """ Gets the next_start_with of this ListObjects. - The name of the object to use in the 'start' parameter to obtain the next page of + The name of the object to use in the `start` parameter to obtain the next page of a truncated ListObjects response. Avoid entering confidential information. Example: test/object1.log @@ -117,7 +117,7 @@ def next_start_with(self): def next_start_with(self, next_start_with): """ Sets the next_start_with of this ListObjects. - The name of the object to use in the 'start' parameter to obtain the next page of + The name of the object to use in the `start` parameter to obtain the next page of a truncated ListObjects response. Avoid entering confidential information. Example: test/object1.log diff --git a/src/oci/object_storage/models/multipart_upload.py b/src/oci/object_storage/models/multipart_upload.py index 49dc375ac9..fefa9b31a2 100644 --- a/src/oci/object_storage/models/multipart_upload.py +++ b/src/oci/object_storage/models/multipart_upload.py @@ -24,6 +24,18 @@ class MultipartUpload(object): __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ + #: A constant which can be used with the storage_tier property of a MultipartUpload. + #: This constant has a value of "Standard" + STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the storage_tier property of a MultipartUpload. + #: This constant has a value of "InfrequentAccess" + STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the storage_tier property of a MultipartUpload. + #: This constant has a value of "Archive" + STORAGE_TIER_ARCHIVE = "Archive" + def __init__(self, **kwargs): """ Initializes a new MultipartUpload object with values from keyword arguments. @@ -49,13 +61,20 @@ def __init__(self, **kwargs): The value to assign to the time_created property of this MultipartUpload. :type time_created: datetime + :param storage_tier: + The value to assign to the storage_tier property of this MultipartUpload. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type storage_tier: str + """ self.swagger_types = { 'namespace': 'str', 'bucket': 'str', 'object': 'str', 'upload_id': 'str', - 'time_created': 'datetime' + 'time_created': 'datetime', + 'storage_tier': 'str' } self.attribute_map = { @@ -63,7 +82,8 @@ def __init__(self, **kwargs): 'bucket': 'bucket', 'object': 'object', 'upload_id': 'uploadId', - 'time_created': 'timeCreated' + 'time_created': 'timeCreated', + 'storage_tier': 'storageTier' } self._namespace = None @@ -71,6 +91,7 @@ def __init__(self, **kwargs): self._object = None self._upload_id = None self._time_created = None + self._storage_tier = None @property def namespace(self): @@ -196,6 +217,36 @@ def time_created(self, time_created): """ self._time_created = time_created + @property + def storage_tier(self): + """ + Gets the storage_tier of this MultipartUpload. + The storage tier that the object is stored in. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The storage_tier of this MultipartUpload. + :rtype: str + """ + return self._storage_tier + + @storage_tier.setter + def storage_tier(self, storage_tier): + """ + Sets the storage_tier of this MultipartUpload. + The storage tier that the object is stored in. + + + :param storage_tier: The storage_tier of this MultipartUpload. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(storage_tier, allowed_values): + storage_tier = 'UNKNOWN_ENUM_VALUE' + self._storage_tier = storage_tier + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/object_storage/models/object_lifecycle_rule.py b/src/oci/object_storage/models/object_lifecycle_rule.py index 2f59a66294..fd048991f4 100644 --- a/src/oci/object_storage/models/object_lifecycle_rule.py +++ b/src/oci/object_storage/models/object_lifecycle_rule.py @@ -119,9 +119,10 @@ def target(self): Gets the target of this ObjectLifecycleRule. The target of the object lifecycle policy rule. The values of target can be either \"objects\", \"multipart-uploads\" or \"previous-object-versions\". - This field when declared as \"objects\" is used to specify ARCHIVE or DELETE rule for objects. - This field when declared as \"previous-object-versions\" is used to specify ARCHIVE or DELETE - rule for previous versions of existing objects. + This field when declared as \"objects\" is used to specify ARCHIVE, INFREQUENT_ACCESS + or DELETE rule for objects. + This field when declared as \"previous-object-versions\" is used to specify ARCHIVE, + INFREQUENT_ACCESS or DELETE rule for previous versions of existing objects. This field when declared as \"multipart-uploads\" is used to specify the ABORT (only) rule for uncommitted multipart-uploads. @@ -137,9 +138,10 @@ def target(self, target): Sets the target of this ObjectLifecycleRule. The target of the object lifecycle policy rule. The values of target can be either \"objects\", \"multipart-uploads\" or \"previous-object-versions\". - This field when declared as \"objects\" is used to specify ARCHIVE or DELETE rule for objects. - This field when declared as \"previous-object-versions\" is used to specify ARCHIVE or DELETE - rule for previous versions of existing objects. + This field when declared as \"objects\" is used to specify ARCHIVE, INFREQUENT_ACCESS + or DELETE rule for objects. + This field when declared as \"previous-object-versions\" is used to specify ARCHIVE, + INFREQUENT_ACCESS or DELETE rule for previous versions of existing objects. This field when declared as \"multipart-uploads\" is used to specify the ABORT (only) rule for uncommitted multipart-uploads. @@ -154,8 +156,11 @@ def action(self): """ **[Required]** Gets the action of this ObjectLifecycleRule. The action of the object lifecycle policy rule. - Rules using the action 'ARCHIVE' move objects from Standard storage tier into the - `Archive Storage tier]`__. + Rules using the action 'ARCHIVE' move objects from Standard and InfrequentAccess storage tiers + into the `Archive storage tier`__. + Rules using the action 'INFREQUENT_ACCESS' move objects from Standard storage tier into the + Infrequent Access Storage tier. Objects that are already in InfrequentAccess tier or in Archive + tier are left untouched. Rules using the action 'DELETE' permanently delete objects from buckets. Rules using 'ABORT' abort the uncommitted multipart-uploads and permanently delete their parts from buckets. @@ -172,8 +177,11 @@ def action(self, action): """ Sets the action of this ObjectLifecycleRule. The action of the object lifecycle policy rule. - Rules using the action 'ARCHIVE' move objects from Standard storage tier into the - `Archive Storage tier]`__. + Rules using the action 'ARCHIVE' move objects from Standard and InfrequentAccess storage tiers + into the `Archive storage tier`__. + Rules using the action 'INFREQUENT_ACCESS' move objects from Standard storage tier into the + Infrequent Access Storage tier. Objects that are already in InfrequentAccess tier or in Archive + tier are left untouched. Rules using the action 'DELETE' permanently delete objects from buckets. Rules using 'ABORT' abort the uncommitted multipart-uploads and permanently delete their parts from buckets. diff --git a/src/oci/object_storage/models/object_summary.py b/src/oci/object_storage/models/object_summary.py index 38be329daf..7db9babffc 100644 --- a/src/oci/object_storage/models/object_summary.py +++ b/src/oci/object_storage/models/object_summary.py @@ -17,6 +17,30 @@ class ObjectSummary(object): __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ + #: A constant which can be used with the storage_tier property of a ObjectSummary. + #: This constant has a value of "Standard" + STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the storage_tier property of a ObjectSummary. + #: This constant has a value of "InfrequentAccess" + STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the storage_tier property of a ObjectSummary. + #: This constant has a value of "Archive" + STORAGE_TIER_ARCHIVE = "Archive" + + #: A constant which can be used with the archival_state property of a ObjectSummary. + #: This constant has a value of "Archived" + ARCHIVAL_STATE_ARCHIVED = "Archived" + + #: A constant which can be used with the archival_state property of a ObjectSummary. + #: This constant has a value of "Restoring" + ARCHIVAL_STATE_RESTORING = "Restoring" + + #: A constant which can be used with the archival_state property of a ObjectSummary. + #: This constant has a value of "Restored" + ARCHIVAL_STATE_RESTORED = "Restored" + def __init__(self, **kwargs): """ Initializes a new ObjectSummary object with values from keyword arguments. @@ -42,6 +66,18 @@ def __init__(self, **kwargs): The value to assign to the etag property of this ObjectSummary. :type etag: str + :param storage_tier: + The value to assign to the storage_tier property of this ObjectSummary. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type storage_tier: str + + :param archival_state: + The value to assign to the archival_state property of this ObjectSummary. + Allowed values for this property are: "Archived", "Restoring", "Restored", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type archival_state: str + :param time_modified: The value to assign to the time_modified property of this ObjectSummary. :type time_modified: datetime @@ -53,6 +89,8 @@ def __init__(self, **kwargs): 'md5': 'str', 'time_created': 'datetime', 'etag': 'str', + 'storage_tier': 'str', + 'archival_state': 'str', 'time_modified': 'datetime' } @@ -62,6 +100,8 @@ def __init__(self, **kwargs): 'md5': 'md5', 'time_created': 'timeCreated', 'etag': 'etag', + 'storage_tier': 'storageTier', + 'archival_state': 'archivalState', 'time_modified': 'timeModified' } @@ -70,6 +110,8 @@ def __init__(self, **kwargs): self._md5 = None self._time_created = None self._etag = None + self._storage_tier = None + self._archival_state = None self._time_modified = None @property @@ -198,6 +240,66 @@ def etag(self, etag): """ self._etag = etag + @property + def storage_tier(self): + """ + Gets the storage_tier of this ObjectSummary. + The storage tier that the object is stored in. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The storage_tier of this ObjectSummary. + :rtype: str + """ + return self._storage_tier + + @storage_tier.setter + def storage_tier(self, storage_tier): + """ + Sets the storage_tier of this ObjectSummary. + The storage tier that the object is stored in. + + + :param storage_tier: The storage_tier of this ObjectSummary. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(storage_tier, allowed_values): + storage_tier = 'UNKNOWN_ENUM_VALUE' + self._storage_tier = storage_tier + + @property + def archival_state(self): + """ + Gets the archival_state of this ObjectSummary. + Archival state of an object. This field is set only for objects in Archive tier. + + Allowed values for this property are: "Archived", "Restoring", "Restored", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The archival_state of this ObjectSummary. + :rtype: str + """ + return self._archival_state + + @archival_state.setter + def archival_state(self, archival_state): + """ + Sets the archival_state of this ObjectSummary. + Archival state of an object. This field is set only for objects in Archive tier. + + + :param archival_state: The archival_state of this ObjectSummary. + :type: str + """ + allowed_values = ["Archived", "Restoring", "Restored"] + if not value_allowed_none_or_none_sentinel(archival_state, allowed_values): + archival_state = 'UNKNOWN_ENUM_VALUE' + self._archival_state = archival_state + @property def time_modified(self): """ diff --git a/src/oci/object_storage/models/object_version_summary.py b/src/oci/object_storage/models/object_version_summary.py index a649ddc08b..e9cfa09659 100644 --- a/src/oci/object_storage/models/object_version_summary.py +++ b/src/oci/object_storage/models/object_version_summary.py @@ -17,6 +17,30 @@ class ObjectVersionSummary(object): __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm """ + #: A constant which can be used with the storage_tier property of a ObjectVersionSummary. + #: This constant has a value of "Standard" + STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the storage_tier property of a ObjectVersionSummary. + #: This constant has a value of "InfrequentAccess" + STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the storage_tier property of a ObjectVersionSummary. + #: This constant has a value of "Archive" + STORAGE_TIER_ARCHIVE = "Archive" + + #: A constant which can be used with the archival_state property of a ObjectVersionSummary. + #: This constant has a value of "Archived" + ARCHIVAL_STATE_ARCHIVED = "Archived" + + #: A constant which can be used with the archival_state property of a ObjectVersionSummary. + #: This constant has a value of "Restoring" + ARCHIVAL_STATE_RESTORING = "Restoring" + + #: A constant which can be used with the archival_state property of a ObjectVersionSummary. + #: This constant has a value of "Restored" + ARCHIVAL_STATE_RESTORED = "Restored" + def __init__(self, **kwargs): """ Initializes a new ObjectVersionSummary object with values from keyword arguments. @@ -46,6 +70,18 @@ def __init__(self, **kwargs): The value to assign to the etag property of this ObjectVersionSummary. :type etag: str + :param storage_tier: + The value to assign to the storage_tier property of this ObjectVersionSummary. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type storage_tier: str + + :param archival_state: + The value to assign to the archival_state property of this ObjectVersionSummary. + Allowed values for this property are: "Archived", "Restoring", "Restored", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type archival_state: str + :param version_id: The value to assign to the version_id property of this ObjectVersionSummary. :type version_id: str @@ -62,6 +98,8 @@ def __init__(self, **kwargs): 'time_created': 'datetime', 'time_modified': 'datetime', 'etag': 'str', + 'storage_tier': 'str', + 'archival_state': 'str', 'version_id': 'str', 'is_delete_marker': 'bool' } @@ -73,6 +111,8 @@ def __init__(self, **kwargs): 'time_created': 'timeCreated', 'time_modified': 'timeModified', 'etag': 'etag', + 'storage_tier': 'storageTier', + 'archival_state': 'archivalState', 'version_id': 'versionId', 'is_delete_marker': 'isDeleteMarker' } @@ -83,6 +123,8 @@ def __init__(self, **kwargs): self._time_created = None self._time_modified = None self._etag = None + self._storage_tier = None + self._archival_state = None self._version_id = None self._is_delete_marker = None @@ -240,6 +282,66 @@ def etag(self, etag): """ self._etag = etag + @property + def storage_tier(self): + """ + Gets the storage_tier of this ObjectVersionSummary. + The storage tier that the object is stored in. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The storage_tier of this ObjectVersionSummary. + :rtype: str + """ + return self._storage_tier + + @storage_tier.setter + def storage_tier(self, storage_tier): + """ + Sets the storage_tier of this ObjectVersionSummary. + The storage tier that the object is stored in. + + + :param storage_tier: The storage_tier of this ObjectVersionSummary. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(storage_tier, allowed_values): + storage_tier = 'UNKNOWN_ENUM_VALUE' + self._storage_tier = storage_tier + + @property + def archival_state(self): + """ + Gets the archival_state of this ObjectVersionSummary. + Archival state of an object. This field is set only for objects in Archive tier. + + Allowed values for this property are: "Archived", "Restoring", "Restored", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The archival_state of this ObjectVersionSummary. + :rtype: str + """ + return self._archival_state + + @archival_state.setter + def archival_state(self, archival_state): + """ + Sets the archival_state of this ObjectVersionSummary. + Archival state of an object. This field is set only for objects in Archive tier. + + + :param archival_state: The archival_state of this ObjectVersionSummary. + :type: str + """ + allowed_values = ["Archived", "Restoring", "Restored"] + if not value_allowed_none_or_none_sentinel(archival_state, allowed_values): + archival_state = 'UNKNOWN_ENUM_VALUE' + self._archival_state = archival_state + @property def version_id(self): """ diff --git a/src/oci/object_storage/models/rename_object_details.py b/src/oci/object_storage/models/rename_object_details.py index 3a7e1ffacc..197c5c0868 100644 --- a/src/oci/object_storage/models/rename_object_details.py +++ b/src/oci/object_storage/models/rename_object_details.py @@ -93,7 +93,7 @@ def source_name(self, source_name): def new_name(self): """ **[Required]** Gets the new_name of this RenameObjectDetails. - The new name of the source object. + The new name of the source object. Avoid entering confidential information. :return: The new_name of this RenameObjectDetails. @@ -105,7 +105,7 @@ def new_name(self): def new_name(self, new_name): """ Sets the new_name of this RenameObjectDetails. - The new name of the source object. + The new name of the source object. Avoid entering confidential information. :param new_name: The new_name of this RenameObjectDetails. diff --git a/src/oci/object_storage/models/retention_rule_details.py b/src/oci/object_storage/models/retention_rule_details.py index c5a7dc9fce..cc557843ae 100644 --- a/src/oci/object_storage/models/retention_rule_details.py +++ b/src/oci/object_storage/models/retention_rule_details.py @@ -52,6 +52,7 @@ def display_name(self): """ Gets the display_name of this RetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :return: The display_name of this RetentionRuleDetails. @@ -64,6 +65,7 @@ def display_name(self, display_name): """ Sets the display_name of this RetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :param display_name: The display_name of this RetentionRuleDetails. diff --git a/src/oci/object_storage/models/update_object_storage_tier_details.py b/src/oci/object_storage/models/update_object_storage_tier_details.py new file mode 100644 index 0000000000..471aa57973 --- /dev/null +++ b/src/oci/object_storage/models/update_object_storage_tier_details.py @@ -0,0 +1,157 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateObjectStorageTierDetails(object): + """ + To change the storage tier of an object, we specify the object name and the desired + storage tier in the body. Objects can be moved between Standard and InfrequentAccess + tiers and from Standard or InfrequentAccess tier to Archive tier. If a version id is + specified, only the specified version of the object is moved to a different storage + tier, else the current version is used. + """ + + #: A constant which can be used with the storage_tier property of a UpdateObjectStorageTierDetails. + #: This constant has a value of "Standard" + STORAGE_TIER_STANDARD = "Standard" + + #: A constant which can be used with the storage_tier property of a UpdateObjectStorageTierDetails. + #: This constant has a value of "InfrequentAccess" + STORAGE_TIER_INFREQUENT_ACCESS = "InfrequentAccess" + + #: A constant which can be used with the storage_tier property of a UpdateObjectStorageTierDetails. + #: This constant has a value of "Archive" + STORAGE_TIER_ARCHIVE = "Archive" + + def __init__(self, **kwargs): + """ + Initializes a new UpdateObjectStorageTierDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param object_name: + The value to assign to the object_name property of this UpdateObjectStorageTierDetails. + :type object_name: str + + :param storage_tier: + The value to assign to the storage_tier property of this UpdateObjectStorageTierDetails. + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + :type storage_tier: str + + :param version_id: + The value to assign to the version_id property of this UpdateObjectStorageTierDetails. + :type version_id: str + + """ + self.swagger_types = { + 'object_name': 'str', + 'storage_tier': 'str', + 'version_id': 'str' + } + + self.attribute_map = { + 'object_name': 'objectName', + 'storage_tier': 'storageTier', + 'version_id': 'versionId' + } + + self._object_name = None + self._storage_tier = None + self._version_id = None + + @property + def object_name(self): + """ + **[Required]** Gets the object_name of this UpdateObjectStorageTierDetails. + An object for which the storage tier needs to be changed. + + + :return: The object_name of this UpdateObjectStorageTierDetails. + :rtype: str + """ + return self._object_name + + @object_name.setter + def object_name(self, object_name): + """ + Sets the object_name of this UpdateObjectStorageTierDetails. + An object for which the storage tier needs to be changed. + + + :param object_name: The object_name of this UpdateObjectStorageTierDetails. + :type: str + """ + self._object_name = object_name + + @property + def storage_tier(self): + """ + **[Required]** Gets the storage_tier of this UpdateObjectStorageTierDetails. + The storage tier that the object should be moved to. + + Allowed values for this property are: "Standard", "InfrequentAccess", "Archive" + + + :return: The storage_tier of this UpdateObjectStorageTierDetails. + :rtype: str + """ + return self._storage_tier + + @storage_tier.setter + def storage_tier(self, storage_tier): + """ + Sets the storage_tier of this UpdateObjectStorageTierDetails. + The storage tier that the object should be moved to. + + + :param storage_tier: The storage_tier of this UpdateObjectStorageTierDetails. + :type: str + """ + allowed_values = ["Standard", "InfrequentAccess", "Archive"] + if not value_allowed_none_or_none_sentinel(storage_tier, allowed_values): + raise ValueError( + "Invalid value for `storage_tier`, must be None or one of {0}" + .format(allowed_values) + ) + self._storage_tier = storage_tier + + @property + def version_id(self): + """ + Gets the version_id of this UpdateObjectStorageTierDetails. + The versionId of the object. Current object version is used by default. + + + :return: The version_id of this UpdateObjectStorageTierDetails. + :rtype: str + """ + return self._version_id + + @version_id.setter + def version_id(self, version_id): + """ + Sets the version_id of this UpdateObjectStorageTierDetails. + The versionId of the object. Current object version is used by default. + + + :param version_id: The version_id of this UpdateObjectStorageTierDetails. + :type: str + """ + self._version_id = version_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/object_storage/models/update_retention_rule_details.py b/src/oci/object_storage/models/update_retention_rule_details.py index 6141d9cbb6..8177a8cf8d 100644 --- a/src/oci/object_storage/models/update_retention_rule_details.py +++ b/src/oci/object_storage/models/update_retention_rule_details.py @@ -52,6 +52,7 @@ def display_name(self): """ Gets the display_name of this UpdateRetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :return: The display_name of this UpdateRetentionRuleDetails. @@ -64,6 +65,7 @@ def display_name(self, display_name): """ Sets the display_name of this UpdateRetentionRuleDetails. A user-specified name for the retention rule. Names can be helpful in identifying retention rules. + Avoid entering confidential information. :param display_name: The display_name of this UpdateRetentionRuleDetails. diff --git a/src/oci/object_storage/object_storage_client.py b/src/oci/object_storage/object_storage_client.py index 7f6339f378..c190740d59 100644 --- a/src/oci/object_storage/object_storage_client.py +++ b/src/oci/object_storage/object_storage_client.py @@ -276,13 +276,13 @@ def commit_multipart_upload(self, namespace_name, bucket_name, object_name, uplo The part numbers and entity tags (ETags) for the parts you want to commit. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -598,13 +598,13 @@ def create_multipart_upload(self, namespace_name, bucket_name, create_multipart_ Request object for creating a multipart upload. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -978,8 +978,9 @@ def delete_bucket(self, namespace_name, bucket_name, **kwargs): Example: `my-new-bucket1` :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -1066,8 +1067,9 @@ def delete_object(self, namespace_name, bucket_name, object_name, **kwargs): Example: `test/object1.log` :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -1165,8 +1167,9 @@ def delete_object_lifecycle_policy(self, namespace_name, bucket_name, **kwargs): The client request ID for tracing. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -1414,8 +1417,9 @@ def delete_retention_rule(self, namespace_name, bucket_name, retention_rule_id, The ID of the retention rule. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -1499,13 +1503,13 @@ def get_bucket(self, namespace_name, bucket_name, **kwargs): Example: `my-new-bucket1` :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -1786,13 +1790,13 @@ def get_object(self, namespace_name, bucket_name, object_name, **kwargs): VersionId used to identify a particular version of the object :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2360,13 +2364,13 @@ def head_bucket(self, namespace_name, bucket_name, **kwargs): Example: `my-new-bucket1` :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2458,13 +2462,13 @@ def head_object(self, namespace_name, bucket_name, object_name, **kwargs): VersionId used to identify a particular version of the object :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2576,6 +2580,9 @@ def list_buckets(self, namespace_name, compartment_id, **kwargs): Gets a list of all BucketSummary items in a compartment. A BucketSummary contains only summary fields for the bucket and does not contain fields like the user-defined metadata. + ListBuckets returns a BucketSummary containing at most 1000 buckets. To paginate through more buckets, use the returned + `opc-next-page` value with the `page` request parameter. + To use this and other 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`__. @@ -2590,10 +2597,17 @@ def list_buckets(self, namespace_name, compartment_id, **kwargs): The ID of the compartment in which to list buckets. :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param list[str] fields: (optional) Bucket summary in list of buckets includes the 'namespace', 'name', 'compartmentId', 'createdBy', 'timeCreated', @@ -2710,10 +2724,17 @@ def list_multipart_upload_parts(self, namespace_name, bucket_name, object_name, The upload ID for a multipart upload. :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2808,10 +2829,17 @@ def list_multipart_uploads(self, namespace_name, bucket_name, **kwargs): Example: `my-new-bucket1` :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2895,6 +2923,9 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): """ Lists the object versions in a bucket. + ListObjectVersions returns an ObjectVersionCollection containing at most 1000 object versions. To paginate through + more object versions, use the returned `opc-next-page` value with the `page` request parameter. + To use this and other 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`__. @@ -2919,7 +2950,11 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): Object names returned by a list query must be strictly less than this parameter. :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str delimiter: (optional) When this parameter is set, only objects whose names do not contain the delimiter character @@ -2929,13 +2964,13 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): Note that only '/' is a supported delimiter character at this time. :param str fields: (optional) - Object summary in list of objects includes the 'name' field. This parameter can also include 'size' - (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time) and 'timeModified' - (object modification date and time). - Value of this parameter should be a comma-separated, case-insensitive list of those field names. - For example 'name,etag,timeCreated,md5,timeModified' + Object summary by default includes only the 'name' field. Use this parameter to also + include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), + 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. + Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. + For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'. - Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified" + Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified", "storageTier", "archivalState" :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -2944,7 +2979,10 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): Object names returned by a list query must be greater than this parameter. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3035,7 +3073,12 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): def list_objects(self, namespace_name, bucket_name, **kwargs): """ - Lists the objects in a bucket. + Lists the objects in a bucket. By default, ListObjects returns object names only. See the `fields` + parameter for other fields that you can optionally include in ListObjects response. + + ListObjects returns at most 1000 objects. To paginate through more objects, use the returned 'nextStartWith' + value with the 'start' parameter. To filter which objects ListObjects returns, use the 'start' and 'end' + parameters. To use this and other 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 @@ -3061,7 +3104,11 @@ def list_objects(self, namespace_name, bucket_name, **kwargs): Object names returned by a list query must be strictly less than this parameter. :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str delimiter: (optional) When this parameter is set, only objects whose names do not contain the delimiter character @@ -3071,13 +3118,13 @@ def list_objects(self, namespace_name, bucket_name, **kwargs): Note that only '/' is a supported delimiter character at this time. :param str fields: (optional) - Object summary in list of objects includes the 'name' field. This parameter can also include 'size' - (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time) and 'timeModified' - (object modification date and time). - Value of this parameter should be a comma-separated, case-insensitive list of those field names. - For example 'name,etag,timeCreated,md5,timeModified' + Object summary by default includes only the 'name' field. Use this parameter to also + include 'size' (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time), + 'timeModified' (object modification date and time), 'storageTier' and 'archivalState' fields. + Specify the value of this parameter as a comma-separated, case-insensitive list of those field names. + For example 'name,etag,timeCreated,md5,timeModified,storageTier,archivalState'. - Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified" + Allowed values are: "name", "size", "etag", "timeCreated", "md5", "timeModified", "storageTier", "archivalState" :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -3186,10 +3233,17 @@ def list_preauthenticated_requests(self, namespace_name, bucket_name, **kwargs): User-specified object name prefixes can be used to query and return a list of pre-authenticated requests. :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -3287,10 +3341,17 @@ def list_replication_policies(self, namespace_name, bucket_name, **kwargs): The client request ID for tracing. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3383,10 +3444,17 @@ def list_replication_sources(self, namespace_name, bucket_name, **kwargs): The client request ID for tracing. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3477,7 +3545,10 @@ def list_retention_rules(self, namespace_name, bucket_name, **kwargs): Example: `my-new-bucket1` :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3558,10 +3629,17 @@ def list_work_request_errors(self, work_request_id, **kwargs): The ID of the asynchronous request. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -3649,10 +3727,17 @@ def list_work_request_logs(self, work_request_id, **kwargs): The ID of the asynchronous request. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -3743,10 +3828,17 @@ def list_work_requests(self, compartment_id, **kwargs): The client request ID for tracing. :param str page: (optional) - The page at which to start retrieving results. + For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important + details about how pagination works, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param int limit: (optional) - The maximum number of items to return. + For list pagination. The maximum number of results per page, or items to return in a paginated + \"List\" call. For important details about how pagination works, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -3925,13 +4017,13 @@ def put_object(self, namespace_name, bucket_name, object_name, put_object_body, The content length of the body. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -3998,6 +4090,12 @@ def put_object(self, namespace_name, bucket_name, object_name, put_object_body, __ https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm + :param str storage_tier: (optional) + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values are: "Standard", "InfrequentAccess", "Archive" + :param dict(str, str) opc_meta: (optional) Optional user-defined metadata key and value. @@ -4037,6 +4135,7 @@ def put_object(self, namespace_name, bucket_name, object_name, put_object_body, "opc_sse_customer_algorithm", "opc_sse_customer_key", "opc_sse_customer_key_sha256", + "storage_tier", "opc_meta" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] @@ -4072,6 +4171,7 @@ def put_object(self, namespace_name, bucket_name, object_name, put_object_body, "opc-sse-customer-algorithm": kwargs.get("opc_sse_customer_algorithm", missing), "opc-sse-customer-key": kwargs.get("opc_sse_customer_key", missing), "opc-sse-customer-key-sha256": kwargs.get("opc_sse_customer_key_sha256", missing), + "storage-tier": kwargs.get("storage_tier", missing), } for key, value in six.iteritems(kwargs.get("opc_meta", {})): @@ -4137,13 +4237,13 @@ def put_object_lifecycle_policy(self, namespace_name, bucket_name, put_object_li The client request ID for tracing. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param obj retry_strategy: (optional) A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level. @@ -4433,7 +4533,7 @@ def rename_object(self, namespace_name, bucket_name, rename_object_details, **kw Example: `my-new-bucket1` :param oci.object_storage.models.RenameObjectDetails rename_object_details: (required) - The sourceName and newName of rename operation. + The sourceName and newName of rename operation. Avoid entering confidential information. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -4609,8 +4709,9 @@ def update_bucket(self, namespace_name, bucket_name, update_bucket_details, **kw Request object for updating a bucket. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -4770,6 +4871,89 @@ def update_namespace_metadata(self, namespace_name, update_namespace_metadata_de body=update_namespace_metadata_details, response_type="NamespaceMetadata") + def update_object_storage_tier(self, namespace_name, bucket_name, update_object_storage_tier_details, **kwargs): + """ + Changes the storage tier of the object specified by the objectName parameter. + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str bucket_name: (required) + The name of the bucket. Avoid entering confidential information. + Example: `my-new-bucket1` + + :param oci.object_storage.models.UpdateObjectStorageTierDetails update_object_storage_tier_details: (required) + The object name and the desired storage tier. + + :param str opc_client_request_id: (optional) + The client request ID for tracing. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type None + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use update_object_storage_tier API. + """ + resource_path = "/n/{namespaceName}/b/{bucketName}/actions/updateObjectStorageTier" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_client_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "update_object_storage_tier got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "namespaceName": namespace_name, + "bucketName": bucket_name + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-client-request-id": kwargs.get("opc_client_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_object_storage_tier_details) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_object_storage_tier_details) + def update_retention_rule(self, namespace_name, bucket_name, retention_rule_id, update_retention_rule_details, **kwargs): """ Updates the specified retention rule. Rule changes take effect typically within 30 seconds. @@ -4789,8 +4973,9 @@ def update_retention_rule(self, namespace_name, bucket_name, retention_rule_id, Request object for updating the retention rule. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -4897,13 +5082,13 @@ def upload_part(self, namespace_name, bucket_name, object_name, upload_id, uploa The client request ID for tracing. :param str if_match: (optional) - The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object. - For uploading a part, this is the entity tag of the target part. + The entity tag (ETag) to match with the ETag of an existing resource. If the specified ETag matches the ETag of + the existing resource, GET and HEAD requests will return the resource and PUT and POST requests will upload + the resource. :param str if_none_match: (optional) - The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object - already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a - part, this is the entity tag of the target part. + The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should + fail if the resource already exists. :param str expect: (optional) 100-continue diff --git a/src/oci/object_storage/transfer/internal/multipart_object_assembler.py b/src/oci/object_storage/transfer/internal/multipart_object_assembler.py index e49eebc514..e60fa55250 100644 --- a/src/oci/object_storage/transfer/internal/multipart_object_assembler.py +++ b/src/oci/object_storage/transfer/internal/multipart_object_assembler.py @@ -98,6 +98,12 @@ def __init__(self, :param str opc_sse_customer_key_sha256 (optional): The base64-encoded SHA256 hash of the encryption key. + + :param str storage_tier: (optional) + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values are: "Standard", "InfrequentAccess", "Archive" """ self.object_storage_client = object_storage_client @@ -122,7 +128,9 @@ def __init__(self, self.metadata = None if 'metadata' in kwargs: self.metadata = kwargs['metadata'] - + self.storage_tier = None + if 'storage_tier' in kwargs: + self.storage_tier = kwargs['storage_tier'] self.parallel_process_count = DEFAULT_PARALLEL_PROCESS_COUNT if 'parallel_process_count' in kwargs: if kwargs['parallel_process_count'] == 0: @@ -361,7 +369,8 @@ def new_upload(self, **kwargs): self.metadata = processed_metadata request.metadata = self.metadata - + if self.storage_tier: + request.storage_tier = self.storage_tier client_request_id = None if 'opc_client_request_id' in kwargs: client_request_id = kwargs['opc_client_request_id'] diff --git a/src/oci/object_storage/transfer/upload_manager.py b/src/oci/object_storage/transfer/upload_manager.py index d691344eaa..8314fceee2 100644 --- a/src/oci/object_storage/transfer/upload_manager.py +++ b/src/oci/object_storage/transfer/upload_manager.py @@ -99,6 +99,12 @@ def upload_stream(self, :param dict metadata (optional): A dictionary of string to string values to associate with the object to upload + :param str storage_tier: (optional) + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values are: "Standard", "InfrequentAccess", "Archive" + :return: The response from multipart commit operation or the put operation. In both cases this will be a :class:`~oci.response.Response` object with data of type None. For a multipart upload (non-empty stream data) the :class:`~oci.response.Response` will contain the :code:`opc-multipart-md5` header and for a non-multipart upload @@ -209,6 +215,12 @@ def upload_file(self, :param dict metadata (optional): A dictionary of string to string values to associate with the object to upload + :param str storage_tier: (optional) + The storage tier that the object should be stored in. If not specified, the object will be stored in + the same storage tier as the bucket. + + Allowed values are: "Standard", "InfrequentAccess", "Archive" + :return: The response from multipart commit operation or the put operation. In both cases this will be a :class:`~oci.response.Response` object with data of type None. For a multipart upload the :class:`~oci.response.Response` will contain the :code:`opc-multipart-md5` header and for a non-multipart upload diff --git a/src/oci/resource_manager/models/__init__.py b/src/oci/resource_manager/models/__init__.py index 41d1bf3c5d..77b69d38fd 100644 --- a/src/oci/resource_manager/models/__init__.py +++ b/src/oci/resource_manager/models/__init__.py @@ -9,6 +9,7 @@ from .apply_job_plan_resolution import ApplyJobPlanResolution from .change_configuration_source_provider_compartment_details import ChangeConfigurationSourceProviderCompartmentDetails from .change_stack_compartment_details import ChangeStackCompartmentDetails +from .change_template_compartment_details import ChangeTemplateCompartmentDetails from .compartment_config_source import CompartmentConfigSource from .config_source import ConfigSource from .config_source_record import ConfigSourceRecord @@ -28,6 +29,10 @@ from .create_job_operation_details import CreateJobOperationDetails from .create_plan_job_operation_details import CreatePlanJobOperationDetails from .create_stack_details import CreateStackDetails +from .create_stack_template_config_source_details import CreateStackTemplateConfigSourceDetails +from .create_template_config_source_details import CreateTemplateConfigSourceDetails +from .create_template_details import CreateTemplateDetails +from .create_template_zip_upload_config_source_details import CreateTemplateZipUploadConfigSourceDetails from .create_zip_upload_config_source_details import CreateZipUploadConfigSourceDetails from .destroy_job_operation_details import DestroyJobOperationDetails from .destroy_job_operation_details_summary import DestroyJobOperationDetailsSummary @@ -54,6 +59,13 @@ from .stack_resource_drift_collection import StackResourceDriftCollection from .stack_resource_drift_summary import StackResourceDriftSummary from .stack_summary import StackSummary +from .template import Template +from .template_category_summary import TemplateCategorySummary +from .template_category_summary_collection import TemplateCategorySummaryCollection +from .template_config_source import TemplateConfigSource +from .template_summary import TemplateSummary +from .template_summary_collection import TemplateSummaryCollection +from .template_zip_upload_config_source import TemplateZipUploadConfigSource from .terraform_version_collection import TerraformVersionCollection from .terraform_version_summary import TerraformVersionSummary from .update_config_source_details import UpdateConfigSourceDetails @@ -63,6 +75,9 @@ from .update_gitlab_access_token_configuration_source_provider_details import UpdateGitlabAccessTokenConfigurationSourceProviderDetails from .update_job_details import UpdateJobDetails from .update_stack_details import UpdateStackDetails +from .update_template_config_source_details import UpdateTemplateConfigSourceDetails +from .update_template_details import UpdateTemplateDetails +from .update_template_zip_upload_config_source_details import UpdateTemplateZipUploadConfigSourceDetails from .update_zip_upload_config_source_details import UpdateZipUploadConfigSourceDetails from .work_request import WorkRequest from .work_request_error import WorkRequestError @@ -79,6 +94,7 @@ "ApplyJobPlanResolution": ApplyJobPlanResolution, "ChangeConfigurationSourceProviderCompartmentDetails": ChangeConfigurationSourceProviderCompartmentDetails, "ChangeStackCompartmentDetails": ChangeStackCompartmentDetails, + "ChangeTemplateCompartmentDetails": ChangeTemplateCompartmentDetails, "CompartmentConfigSource": CompartmentConfigSource, "ConfigSource": ConfigSource, "ConfigSourceRecord": ConfigSourceRecord, @@ -98,6 +114,10 @@ "CreateJobOperationDetails": CreateJobOperationDetails, "CreatePlanJobOperationDetails": CreatePlanJobOperationDetails, "CreateStackDetails": CreateStackDetails, + "CreateStackTemplateConfigSourceDetails": CreateStackTemplateConfigSourceDetails, + "CreateTemplateConfigSourceDetails": CreateTemplateConfigSourceDetails, + "CreateTemplateDetails": CreateTemplateDetails, + "CreateTemplateZipUploadConfigSourceDetails": CreateTemplateZipUploadConfigSourceDetails, "CreateZipUploadConfigSourceDetails": CreateZipUploadConfigSourceDetails, "DestroyJobOperationDetails": DestroyJobOperationDetails, "DestroyJobOperationDetailsSummary": DestroyJobOperationDetailsSummary, @@ -124,6 +144,13 @@ "StackResourceDriftCollection": StackResourceDriftCollection, "StackResourceDriftSummary": StackResourceDriftSummary, "StackSummary": StackSummary, + "Template": Template, + "TemplateCategorySummary": TemplateCategorySummary, + "TemplateCategorySummaryCollection": TemplateCategorySummaryCollection, + "TemplateConfigSource": TemplateConfigSource, + "TemplateSummary": TemplateSummary, + "TemplateSummaryCollection": TemplateSummaryCollection, + "TemplateZipUploadConfigSource": TemplateZipUploadConfigSource, "TerraformVersionCollection": TerraformVersionCollection, "TerraformVersionSummary": TerraformVersionSummary, "UpdateConfigSourceDetails": UpdateConfigSourceDetails, @@ -133,6 +160,9 @@ "UpdateGitlabAccessTokenConfigurationSourceProviderDetails": UpdateGitlabAccessTokenConfigurationSourceProviderDetails, "UpdateJobDetails": UpdateJobDetails, "UpdateStackDetails": UpdateStackDetails, + "UpdateTemplateConfigSourceDetails": UpdateTemplateConfigSourceDetails, + "UpdateTemplateDetails": UpdateTemplateDetails, + "UpdateTemplateZipUploadConfigSourceDetails": UpdateTemplateZipUploadConfigSourceDetails, "UpdateZipUploadConfigSourceDetails": UpdateZipUploadConfigSourceDetails, "WorkRequest": WorkRequest, "WorkRequestError": WorkRequestError, diff --git a/src/oci/resource_manager/models/change_template_compartment_details.py b/src/oci/resource_manager/models/change_template_compartment_details.py new file mode 100644 index 0000000000..27c94f1edc --- /dev/null +++ b/src/oci/resource_manager/models/change_template_compartment_details.py @@ -0,0 +1,76 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class ChangeTemplateCompartmentDetails(object): + """ + The details for moving a template to a different compartment. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeTemplateCompartmentDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this ChangeTemplateCompartmentDetails. + :type compartment_id: str + + """ + self.swagger_types = { + 'compartment_id': 'str' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId' + } + + self._compartment_id = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ChangeTemplateCompartmentDetails. + The `OCID`__ of the compartment + to move the configuration source provider to. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ChangeTemplateCompartmentDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ChangeTemplateCompartmentDetails. + The `OCID`__ of the compartment + to move the configuration source provider to. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ChangeTemplateCompartmentDetails. + :type: str + """ + self._compartment_id = compartment_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/create_config_source_details.py b/src/oci/resource_manager/models/create_config_source_details.py index 7cf97bb03a..fca29b2324 100644 --- a/src/oci/resource_manager/models/create_config_source_details.py +++ b/src/oci/resource_manager/models/create_config_source_details.py @@ -21,6 +21,7 @@ def __init__(self, **kwargs): * :class:`~oci.resource_manager.models.CreateZipUploadConfigSourceDetails` * :class:`~oci.resource_manager.models.CreateGitConfigSourceDetails` * :class:`~oci.resource_manager.models.CreateCompartmentConfigSourceDetails` + * :class:`~oci.resource_manager.models.CreateStackTemplateConfigSourceDetails` The following keyword arguments are supported (corresponding to the getters/setters of this class): @@ -62,6 +63,9 @@ def get_subtype(object_dictionary): if type == 'COMPARTMENT_CONFIG_SOURCE': return 'CreateCompartmentConfigSourceDetails' + + if type == 'TEMPLATE_CONFIG_SOURCE': + return 'CreateStackTemplateConfigSourceDetails' else: return 'CreateConfigSourceDetails' diff --git a/src/oci/resource_manager/models/create_stack_template_config_source_details.py b/src/oci/resource_manager/models/create_stack_template_config_source_details.py new file mode 100644 index 0000000000..369c92928b --- /dev/null +++ b/src/oci/resource_manager/models/create_stack_template_config_source_details.py @@ -0,0 +1,82 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .create_config_source_details import CreateConfigSourceDetails +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateStackTemplateConfigSourceDetails(CreateConfigSourceDetails): + """ + The template to use as the source of the Terraform configuration. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateStackTemplateConfigSourceDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.resource_manager.models.CreateStackTemplateConfigSourceDetails.config_source_type` attribute + of this class is ``TEMPLATE_CONFIG_SOURCE`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param config_source_type: + The value to assign to the config_source_type property of this CreateStackTemplateConfigSourceDetails. + :type config_source_type: str + + :param working_directory: + The value to assign to the working_directory property of this CreateStackTemplateConfigSourceDetails. + :type working_directory: str + + :param template_id: + The value to assign to the template_id property of this CreateStackTemplateConfigSourceDetails. + :type template_id: str + + """ + self.swagger_types = { + 'config_source_type': 'str', + 'working_directory': 'str', + 'template_id': 'str' + } + + self.attribute_map = { + 'config_source_type': 'configSourceType', + 'working_directory': 'workingDirectory', + 'template_id': 'templateId' + } + + self._config_source_type = None + self._working_directory = None + self._template_id = None + self._config_source_type = 'TEMPLATE_CONFIG_SOURCE' + + @property + def template_id(self): + """ + **[Required]** Gets the template_id of this CreateStackTemplateConfigSourceDetails. + + :return: The template_id of this CreateStackTemplateConfigSourceDetails. + :rtype: str + """ + return self._template_id + + @template_id.setter + def template_id(self, template_id): + """ + Sets the template_id of this CreateStackTemplateConfigSourceDetails. + + :param template_id: The template_id of this CreateStackTemplateConfigSourceDetails. + :type: str + """ + self._template_id = template_id + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/create_template_config_source_details.py b/src/oci/resource_manager/models/create_template_config_source_details.py new file mode 100644 index 0000000000..cc6726e291 --- /dev/null +++ b/src/oci/resource_manager/models/create_template_config_source_details.py @@ -0,0 +1,87 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateTemplateConfigSourceDetails(object): + """ + Property details for the configuration source used for the template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateTemplateConfigSourceDetails object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this CreateTemplateConfigSourceDetails. + :type template_config_source_type: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType' + } + + self._template_config_source_type = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['templateConfigSourceType'] + + if type == 'ZIP_UPLOAD': + return 'CreateTemplateZipUploadConfigSourceDetails' + else: + return 'CreateTemplateConfigSourceDetails' + + @property + def template_config_source_type(self): + """ + **[Required]** Gets the template_config_source_type of this CreateTemplateConfigSourceDetails. + Specifies the `configSourceType` for uploading the Terraform configuration. + + + :return: The template_config_source_type of this CreateTemplateConfigSourceDetails. + :rtype: str + """ + return self._template_config_source_type + + @template_config_source_type.setter + def template_config_source_type(self, template_config_source_type): + """ + Sets the template_config_source_type of this CreateTemplateConfigSourceDetails. + Specifies the `configSourceType` for uploading the Terraform configuration. + + + :param template_config_source_type: The template_config_source_type of this CreateTemplateConfigSourceDetails. + :type: str + """ + self._template_config_source_type = template_config_source_type + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/create_template_details.py b/src/oci/resource_manager/models/create_template_details.py new file mode 100644 index 0000000000..cc10611b90 --- /dev/null +++ b/src/oci/resource_manager/models/create_template_details.py @@ -0,0 +1,303 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateTemplateDetails(object): + """ + The configuration details for creating a template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateTemplateDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param compartment_id: + The value to assign to the compartment_id property of this CreateTemplateDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateTemplateDetails. + :type display_name: str + + :param description: + The value to assign to the description property of this CreateTemplateDetails. + :type description: str + + :param long_description: + The value to assign to the long_description property of this CreateTemplateDetails. + :type long_description: str + + :param logo_file_base64_encoded: + The value to assign to the logo_file_base64_encoded property of this CreateTemplateDetails. + :type logo_file_base64_encoded: str + + :param template_config_source: + The value to assign to the template_config_source property of this CreateTemplateDetails. + :type template_config_source: oci.resource_manager.models.CreateTemplateConfigSourceDetails + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateTemplateDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateTemplateDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'long_description': 'str', + 'logo_file_base64_encoded': 'str', + 'template_config_source': 'CreateTemplateConfigSourceDetails', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'long_description': 'longDescription', + 'logo_file_base64_encoded': 'logoFileBase64Encoded', + 'template_config_source': 'templateConfigSource', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._description = None + self._long_description = None + self._logo_file_base64_encoded = None + self._template_config_source = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateTemplateDetails. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateTemplateDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateTemplateDetails. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateTemplateDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateTemplateDetails. + The template's display name. Avoid entering confidential information. + + + :return: The display_name of this CreateTemplateDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateTemplateDetails. + The template's display name. Avoid entering confidential information. + + + :param display_name: The display_name of this CreateTemplateDetails. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + **[Required]** Gets the description of this CreateTemplateDetails. + Description of the template. Avoid entering confidential information. + + + :return: The description of this CreateTemplateDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this CreateTemplateDetails. + Description of the template. Avoid entering confidential information. + + + :param description: The description of this CreateTemplateDetails. + :type: str + """ + self._description = description + + @property + def long_description(self): + """ + Gets the long_description of this CreateTemplateDetails. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :return: The long_description of this CreateTemplateDetails. + :rtype: str + """ + return self._long_description + + @long_description.setter + def long_description(self, long_description): + """ + Sets the long_description of this CreateTemplateDetails. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :param long_description: The long_description of this CreateTemplateDetails. + :type: str + """ + self._long_description = long_description + + @property + def logo_file_base64_encoded(self): + """ + Gets the logo_file_base64_encoded of this CreateTemplateDetails. + Base64-encoded logo for the template. + + + :return: The logo_file_base64_encoded of this CreateTemplateDetails. + :rtype: str + """ + return self._logo_file_base64_encoded + + @logo_file_base64_encoded.setter + def logo_file_base64_encoded(self, logo_file_base64_encoded): + """ + Sets the logo_file_base64_encoded of this CreateTemplateDetails. + Base64-encoded logo for the template. + + + :param logo_file_base64_encoded: The logo_file_base64_encoded of this CreateTemplateDetails. + :type: str + """ + self._logo_file_base64_encoded = logo_file_base64_encoded + + @property + def template_config_source(self): + """ + **[Required]** Gets the template_config_source of this CreateTemplateDetails. + + :return: The template_config_source of this CreateTemplateDetails. + :rtype: oci.resource_manager.models.CreateTemplateConfigSourceDetails + """ + return self._template_config_source + + @template_config_source.setter + def template_config_source(self, template_config_source): + """ + Sets the template_config_source of this CreateTemplateDetails. + + :param template_config_source: The template_config_source of this CreateTemplateDetails. + :type: oci.resource_manager.models.CreateTemplateConfigSourceDetails + """ + self._template_config_source = template_config_source + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateTemplateDetails. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateTemplateDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateTemplateDetails. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateTemplateDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateTemplateDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreateTemplateDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this CreateTemplateDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreateTemplateDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/create_template_zip_upload_config_source_details.py b/src/oci/resource_manager/models/create_template_zip_upload_config_source_details.py new file mode 100644 index 0000000000..ef4ba4370a --- /dev/null +++ b/src/oci/resource_manager/models/create_template_zip_upload_config_source_details.py @@ -0,0 +1,75 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .create_template_config_source_details import CreateTemplateConfigSourceDetails +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class CreateTemplateZipUploadConfigSourceDetails(CreateTemplateConfigSourceDetails): + """ + Property details for uploading the zip file for template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateTemplateZipUploadConfigSourceDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.resource_manager.models.CreateTemplateZipUploadConfigSourceDetails.template_config_source_type` attribute + of this class is ``ZIP_UPLOAD`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this CreateTemplateZipUploadConfigSourceDetails. + :type template_config_source_type: str + + :param zip_file_base64_encoded: + The value to assign to the zip_file_base64_encoded property of this CreateTemplateZipUploadConfigSourceDetails. + :type zip_file_base64_encoded: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str', + 'zip_file_base64_encoded': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType', + 'zip_file_base64_encoded': 'zipFileBase64Encoded' + } + + self._template_config_source_type = None + self._zip_file_base64_encoded = None + self._template_config_source_type = 'ZIP_UPLOAD' + + @property + def zip_file_base64_encoded(self): + """ + **[Required]** Gets the zip_file_base64_encoded of this CreateTemplateZipUploadConfigSourceDetails. + + :return: The zip_file_base64_encoded of this CreateTemplateZipUploadConfigSourceDetails. + :rtype: str + """ + return self._zip_file_base64_encoded + + @zip_file_base64_encoded.setter + def zip_file_base64_encoded(self, zip_file_base64_encoded): + """ + Sets the zip_file_base64_encoded of this CreateTemplateZipUploadConfigSourceDetails. + + :param zip_file_base64_encoded: The zip_file_base64_encoded of this CreateTemplateZipUploadConfigSourceDetails. + :type: str + """ + self._zip_file_base64_encoded = zip_file_base64_encoded + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template.py b/src/oci/resource_manager/models/template.py new file mode 100644 index 0000000000..e5cca50d78 --- /dev/null +++ b/src/oci/resource_manager/models/template.py @@ -0,0 +1,416 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class Template(object): + """ + The properties that define a template. A template is a pre-built Terraform configuration that provisions a set of resources used in a common scenario. + """ + + #: A constant which can be used with the lifecycle_state property of a Template. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + def __init__(self, **kwargs): + """ + Initializes a new Template object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param id: + The value to assign to the id property of this Template. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this Template. + :type compartment_id: str + + :param category_id: + The value to assign to the category_id property of this Template. + :type category_id: str + + :param display_name: + The value to assign to the display_name property of this Template. + :type display_name: str + + :param description: + The value to assign to the description property of this Template. + :type description: str + + :param long_description: + The value to assign to the long_description property of this Template. + :type long_description: str + + :param time_created: + The value to assign to the time_created property of this Template. + :type time_created: datetime + + :param template_config_source: + The value to assign to the template_config_source property of this Template. + :type template_config_source: oci.resource_manager.models.TemplateConfigSource + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this Template. + Allowed values for this property are: "ACTIVE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this Template. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this Template. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'category_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'long_description': 'str', + 'time_created': 'datetime', + 'template_config_source': 'TemplateConfigSource', + 'lifecycle_state': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'category_id': 'categoryId', + 'display_name': 'displayName', + 'description': 'description', + 'long_description': 'longDescription', + 'time_created': 'timeCreated', + 'template_config_source': 'templateConfigSource', + 'lifecycle_state': 'lifecycleState', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._compartment_id = None + self._category_id = None + self._display_name = None + self._description = None + self._long_description = None + self._time_created = None + self._template_config_source = None + self._lifecycle_state = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this Template. + Unique identifier (`OCID`__) for the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The id of this Template. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this Template. + Unique identifier (`OCID`__) for the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param id: The id of this Template. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this Template. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this Template. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this Template. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this Template. + :type: str + """ + self._compartment_id = compartment_id + + @property + def category_id(self): + """ + Gets the category_id of this Template. + Unique identifier for the category where the template is located. + + + :return: The category_id of this Template. + :rtype: str + """ + return self._category_id + + @category_id.setter + def category_id(self, category_id): + """ + Sets the category_id of this Template. + Unique identifier for the category where the template is located. + + + :param category_id: The category_id of this Template. + :type: str + """ + self._category_id = category_id + + @property + def display_name(self): + """ + Gets the display_name of this Template. + Human-readable name of the template. + + + :return: The display_name of this Template. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this Template. + Human-readable name of the template. + + + :param display_name: The display_name of this Template. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this Template. + Brief description of the template. + + + :return: The description of this Template. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this Template. + Brief description of the template. + + + :param description: The description of this Template. + :type: str + """ + self._description = description + + @property + def long_description(self): + """ + Gets the long_description of this Template. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :return: The long_description of this Template. + :rtype: str + """ + return self._long_description + + @long_description.setter + def long_description(self, long_description): + """ + Sets the long_description of this Template. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :param long_description: The long_description of this Template. + :type: str + """ + self._long_description = long_description + + @property + def time_created(self): + """ + Gets the time_created of this Template. + The date and time at which the template was created. + Format is defined by RFC3339. + Example: `2020-11-25T21:10:29.600Z` + + + :return: The time_created of this Template. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this Template. + The date and time at which the template was created. + Format is defined by RFC3339. + Example: `2020-11-25T21:10:29.600Z` + + + :param time_created: The time_created of this Template. + :type: datetime + """ + self._time_created = time_created + + @property + def template_config_source(self): + """ + Gets the template_config_source of this Template. + + :return: The template_config_source of this Template. + :rtype: oci.resource_manager.models.TemplateConfigSource + """ + return self._template_config_source + + @template_config_source.setter + def template_config_source(self, template_config_source): + """ + Sets the template_config_source of this Template. + + :param template_config_source: The template_config_source of this Template. + :type: oci.resource_manager.models.TemplateConfigSource + """ + self._template_config_source = template_config_source + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this Template. + The current lifecycle state of the template. + + Allowed values for this property are: "ACTIVE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this Template. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this Template. + The current lifecycle state of the template. + + + :param lifecycle_state: The lifecycle_state of this Template. + :type: str + """ + allowed_values = ["ACTIVE"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this Template. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this Template. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this Template. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this Template. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this Template. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this Template. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this Template. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this Template. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_category_summary.py b/src/oci/resource_manager/models/template_category_summary.py new file mode 100644 index 0000000000..0893baf2c2 --- /dev/null +++ b/src/oci/resource_manager/models/template_category_summary.py @@ -0,0 +1,101 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateCategorySummary(object): + """ + Summary information for the template category. + """ + + def __init__(self, **kwargs): + """ + Initializes a new TemplateCategorySummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param id: + The value to assign to the id property of this TemplateCategorySummary. + :type id: str + + :param display_name: + The value to assign to the display_name property of this TemplateCategorySummary. + :type display_name: str + + """ + self.swagger_types = { + 'id': 'str', + 'display_name': 'str' + } + + self.attribute_map = { + 'id': 'id', + 'display_name': 'displayName' + } + + self._id = None + self._display_name = None + + @property + def id(self): + """ + Gets the id of this TemplateCategorySummary. + Unique identifier for the template category. + + + :return: The id of this TemplateCategorySummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this TemplateCategorySummary. + Unique identifier for the template category. + + + :param id: The id of this TemplateCategorySummary. + :type: str + """ + self._id = id + + @property + def display_name(self): + """ + Gets the display_name of this TemplateCategorySummary. + The name of the template category. + + + :return: The display_name of this TemplateCategorySummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this TemplateCategorySummary. + The name of the template category. + + + :param display_name: The display_name of this TemplateCategorySummary. + :type: str + """ + self._display_name = display_name + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_category_summary_collection.py b/src/oci/resource_manager/models/template_category_summary_collection.py new file mode 100644 index 0000000000..bf898311e9 --- /dev/null +++ b/src/oci/resource_manager/models/template_category_summary_collection.py @@ -0,0 +1,70 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateCategorySummaryCollection(object): + """ + Results of a `ListTemplateCategories` operation. + """ + + def __init__(self, **kwargs): + """ + Initializes a new TemplateCategorySummaryCollection object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param items: + The value to assign to the items property of this TemplateCategorySummaryCollection. + :type items: list[oci.resource_manager.models.TemplateCategorySummary] + + """ + self.swagger_types = { + 'items': 'list[TemplateCategorySummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this TemplateCategorySummaryCollection. + A list of template categories. + + + :return: The items of this TemplateCategorySummaryCollection. + :rtype: list[oci.resource_manager.models.TemplateCategorySummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this TemplateCategorySummaryCollection. + A list of template categories. + + + :param items: The items of this TemplateCategorySummaryCollection. + :type: list[oci.resource_manager.models.TemplateCategorySummary] + """ + self._items = items + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_config_source.py b/src/oci/resource_manager/models/template_config_source.py new file mode 100644 index 0000000000..4fb1b159f4 --- /dev/null +++ b/src/oci/resource_manager/models/template_config_source.py @@ -0,0 +1,99 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateConfigSource(object): + """ + Information about the Template. + """ + + #: A constant which can be used with the template_config_source_type property of a TemplateConfigSource. + #: This constant has a value of "ZIP_UPLOAD" + TEMPLATE_CONFIG_SOURCE_TYPE_ZIP_UPLOAD = "ZIP_UPLOAD" + + def __init__(self, **kwargs): + """ + Initializes a new TemplateConfigSource object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.resource_manager.models.TemplateZipUploadConfigSource` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this TemplateConfigSource. + Allowed values for this property are: "ZIP_UPLOAD", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type template_config_source_type: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType' + } + + self._template_config_source_type = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['templateConfigSourceType'] + + if type == 'ZIP_UPLOAD': + return 'TemplateZipUploadConfigSource' + else: + return 'TemplateConfigSource' + + @property + def template_config_source_type(self): + """ + **[Required]** Gets the template_config_source_type of this TemplateConfigSource. + The type of configuration source to use for the template configuration. + + Allowed values for this property are: "ZIP_UPLOAD", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The template_config_source_type of this TemplateConfigSource. + :rtype: str + """ + return self._template_config_source_type + + @template_config_source_type.setter + def template_config_source_type(self, template_config_source_type): + """ + Sets the template_config_source_type of this TemplateConfigSource. + The type of configuration source to use for the template configuration. + + + :param template_config_source_type: The template_config_source_type of this TemplateConfigSource. + :type: str + """ + allowed_values = ["ZIP_UPLOAD"] + if not value_allowed_none_or_none_sentinel(template_config_source_type, allowed_values): + template_config_source_type = 'UNKNOWN_ENUM_VALUE' + self._template_config_source_type = template_config_source_type + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_summary.py b/src/oci/resource_manager/models/template_summary.py new file mode 100644 index 0000000000..bd6e1a5f63 --- /dev/null +++ b/src/oci/resource_manager/models/template_summary.py @@ -0,0 +1,237 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateSummary(object): + """ + Summary information for a template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new TemplateSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param id: + The value to assign to the id property of this TemplateSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this TemplateSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this TemplateSummary. + :type display_name: str + + :param description: + The value to assign to the description property of this TemplateSummary. + :type description: str + + :param time_created: + The value to assign to the time_created property of this TemplateSummary. + :type time_created: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this TemplateSummary. + :type lifecycle_state: str + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'time_created': 'datetime', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'time_created': 'timeCreated', + 'lifecycle_state': 'lifecycleState' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._time_created = None + self._lifecycle_state = None + + @property + def id(self): + """ + Gets the id of this TemplateSummary. + Unique identifier of the specified template. + + + :return: The id of this TemplateSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this TemplateSummary. + Unique identifier of the specified template. + + + :param id: The id of this TemplateSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this TemplateSummary. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this TemplateSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this TemplateSummary. + The `OCID`__ of the compartment containing this template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this TemplateSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this TemplateSummary. + Human-readable display name for the template. + + + :return: The display_name of this TemplateSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this TemplateSummary. + Human-readable display name for the template. + + + :param display_name: The display_name of this TemplateSummary. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this TemplateSummary. + Brief description of the template. + + + :return: The description of this TemplateSummary. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this TemplateSummary. + Brief description of the template. + + + :param description: The description of this TemplateSummary. + :type: str + """ + self._description = description + + @property + def time_created(self): + """ + Gets the time_created of this TemplateSummary. + The date and time at which the template was created. + Format is defined by RFC3339. + Example: `2020-11-25T21:10:29.600Z` + + + :return: The time_created of this TemplateSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this TemplateSummary. + The date and time at which the template was created. + Format is defined by RFC3339. + Example: `2020-11-25T21:10:29.600Z` + + + :param time_created: The time_created of this TemplateSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this TemplateSummary. + The current lifecycle state of the template. + Allowable values: + - ACTIVE + + + :return: The lifecycle_state of this TemplateSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this TemplateSummary. + The current lifecycle state of the template. + Allowable values: + - ACTIVE + + + :param lifecycle_state: The lifecycle_state of this TemplateSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_summary_collection.py b/src/oci/resource_manager/models/template_summary_collection.py new file mode 100644 index 0000000000..9b19e7bd09 --- /dev/null +++ b/src/oci/resource_manager/models/template_summary_collection.py @@ -0,0 +1,70 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateSummaryCollection(object): + """ + Results of a `ListTemplates` operation. + """ + + def __init__(self, **kwargs): + """ + Initializes a new TemplateSummaryCollection object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param items: + The value to assign to the items property of this TemplateSummaryCollection. + :type items: list[oci.resource_manager.models.TemplateSummary] + + """ + self.swagger_types = { + 'items': 'list[TemplateSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this TemplateSummaryCollection. + A list of template summaries. + + + :return: The items of this TemplateSummaryCollection. + :rtype: list[oci.resource_manager.models.TemplateSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this TemplateSummaryCollection. + A list of template summaries. + + + :param items: The items of this TemplateSummaryCollection. + :type: list[oci.resource_manager.models.TemplateSummary] + """ + self._items = items + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/template_zip_upload_config_source.py b/src/oci/resource_manager/models/template_zip_upload_config_source.py new file mode 100644 index 0000000000..1e99b319f8 --- /dev/null +++ b/src/oci/resource_manager/models/template_zip_upload_config_source.py @@ -0,0 +1,49 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .template_config_source import TemplateConfigSource +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class TemplateZipUploadConfigSource(TemplateConfigSource): + """ + Metadata about the user-provided Terraform configuration. + """ + + def __init__(self, **kwargs): + """ + Initializes a new TemplateZipUploadConfigSource object with values from keyword arguments. The default value of the :py:attr:`~oci.resource_manager.models.TemplateZipUploadConfigSource.template_config_source_type` attribute + of this class is ``ZIP_UPLOAD`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this TemplateZipUploadConfigSource. + Allowed values for this property are: "ZIP_UPLOAD" + :type template_config_source_type: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType' + } + + self._template_config_source_type = None + self._template_config_source_type = 'ZIP_UPLOAD' + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/update_template_config_source_details.py b/src/oci/resource_manager/models/update_template_config_source_details.py new file mode 100644 index 0000000000..a71e8bb701 --- /dev/null +++ b/src/oci/resource_manager/models/update_template_config_source_details.py @@ -0,0 +1,87 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateTemplateConfigSourceDetails(object): + """ + Updates the property details for the configuration source for the template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateTemplateConfigSourceDetails object with values from keyword arguments. This class has the following subclasses and if you are using this class as input + to a service operations then you should favor using a subclass over the base class: + + * :class:`~oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this UpdateTemplateConfigSourceDetails. + :type template_config_source_type: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType' + } + + self._template_config_source_type = None + + @staticmethod + def get_subtype(object_dictionary): + """ + Given the hash representation of a subtype of this class, + use the info in the hash to return the class of the subtype. + """ + type = object_dictionary['templateConfigSourceType'] + + if type == 'ZIP_UPLOAD': + return 'UpdateTemplateZipUploadConfigSourceDetails' + else: + return 'UpdateTemplateConfigSourceDetails' + + @property + def template_config_source_type(self): + """ + **[Required]** Gets the template_config_source_type of this UpdateTemplateConfigSourceDetails. + Specifies the `configSourceType` for uploading the Terraform configuration. + + + :return: The template_config_source_type of this UpdateTemplateConfigSourceDetails. + :rtype: str + """ + return self._template_config_source_type + + @template_config_source_type.setter + def template_config_source_type(self, template_config_source_type): + """ + Sets the template_config_source_type of this UpdateTemplateConfigSourceDetails. + Specifies the `configSourceType` for uploading the Terraform configuration. + + + :param template_config_source_type: The template_config_source_type of this UpdateTemplateConfigSourceDetails. + :type: str + """ + self._template_config_source_type = template_config_source_type + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/update_template_details.py b/src/oci/resource_manager/models/update_template_details.py new file mode 100644 index 0000000000..fd189d5af7 --- /dev/null +++ b/src/oci/resource_manager/models/update_template_details.py @@ -0,0 +1,268 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + + +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateTemplateDetails(object): + """ + Updates the specified template. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateTemplateDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param display_name: + The value to assign to the display_name property of this UpdateTemplateDetails. + :type display_name: str + + :param description: + The value to assign to the description property of this UpdateTemplateDetails. + :type description: str + + :param long_description: + The value to assign to the long_description property of this UpdateTemplateDetails. + :type long_description: str + + :param logo_file_base64_encoded: + The value to assign to the logo_file_base64_encoded property of this UpdateTemplateDetails. + :type logo_file_base64_encoded: str + + :param template_config_source: + The value to assign to the template_config_source property of this UpdateTemplateDetails. + :type template_config_source: oci.resource_manager.models.UpdateTemplateConfigSourceDetails + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateTemplateDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateTemplateDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'description': 'str', + 'long_description': 'str', + 'logo_file_base64_encoded': 'str', + 'template_config_source': 'UpdateTemplateConfigSourceDetails', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'description': 'description', + 'long_description': 'longDescription', + 'logo_file_base64_encoded': 'logoFileBase64Encoded', + 'template_config_source': 'templateConfigSource', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._description = None + self._long_description = None + self._logo_file_base64_encoded = None + self._template_config_source = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + Gets the display_name of this UpdateTemplateDetails. + The template's display name. Avoid entering confidential information. + + + :return: The display_name of this UpdateTemplateDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateTemplateDetails. + The template's display name. Avoid entering confidential information. + + + :param display_name: The display_name of this UpdateTemplateDetails. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this UpdateTemplateDetails. + Description of the template. Avoid entering confidential information. + + + :return: The description of this UpdateTemplateDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this UpdateTemplateDetails. + Description of the template. Avoid entering confidential information. + + + :param description: The description of this UpdateTemplateDetails. + :type: str + """ + self._description = description + + @property + def long_description(self): + """ + Gets the long_description of this UpdateTemplateDetails. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :return: The long_description of this UpdateTemplateDetails. + :rtype: str + """ + return self._long_description + + @long_description.setter + def long_description(self, long_description): + """ + Sets the long_description of this UpdateTemplateDetails. + Detailed description of the template. This description is displayed in the Console page listing templates when the template is expanded. Avoid entering confidential information. + + + :param long_description: The long_description of this UpdateTemplateDetails. + :type: str + """ + self._long_description = long_description + + @property + def logo_file_base64_encoded(self): + """ + Gets the logo_file_base64_encoded of this UpdateTemplateDetails. + Base64-encoded logo for the template. + + + :return: The logo_file_base64_encoded of this UpdateTemplateDetails. + :rtype: str + """ + return self._logo_file_base64_encoded + + @logo_file_base64_encoded.setter + def logo_file_base64_encoded(self, logo_file_base64_encoded): + """ + Sets the logo_file_base64_encoded of this UpdateTemplateDetails. + Base64-encoded logo for the template. + + + :param logo_file_base64_encoded: The logo_file_base64_encoded of this UpdateTemplateDetails. + :type: str + """ + self._logo_file_base64_encoded = logo_file_base64_encoded + + @property + def template_config_source(self): + """ + Gets the template_config_source of this UpdateTemplateDetails. + + :return: The template_config_source of this UpdateTemplateDetails. + :rtype: oci.resource_manager.models.UpdateTemplateConfigSourceDetails + """ + return self._template_config_source + + @template_config_source.setter + def template_config_source(self, template_config_source): + """ + Sets the template_config_source of this UpdateTemplateDetails. + + :param template_config_source: The template_config_source of this UpdateTemplateDetails. + :type: oci.resource_manager.models.UpdateTemplateConfigSourceDetails + """ + self._template_config_source = template_config_source + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateTemplateDetails. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateTemplateDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateTemplateDetails. + Free-form tags associated with the resource. Each tag is a key-value pair with no predefined name, type, or namespace. + For more information, see `Resource Tags`__. + Example: `{\"Department\": \"Finance\"}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateTemplateDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateTemplateDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdateTemplateDetails. + :rtype: dict(str, dict(str, object)) + """ + return self._defined_tags + + @defined_tags.setter + def defined_tags(self, defined_tags): + """ + Sets the defined_tags of this UpdateTemplateDetails. + Defined tags for this resource. Each key is predefined and scoped to a namespace. + For more information, see `Resource Tags`__. + Example: `{\"Operations\": {\"CostCenter\": \"42\"}}` + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdateTemplateDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/models/update_template_zip_upload_config_source_details.py b/src/oci/resource_manager/models/update_template_zip_upload_config_source_details.py new file mode 100644 index 0000000000..ac5580eac2 --- /dev/null +++ b/src/oci/resource_manager/models/update_template_zip_upload_config_source_details.py @@ -0,0 +1,75 @@ +# coding: utf-8 +# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved. +# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. + +from .update_template_config_source_details import UpdateTemplateConfigSourceDetails +from oci.util import formatted_flat_dict, NONE_SENTINEL, value_allowed_none_or_none_sentinel # noqa: F401 +from oci.decorators import init_model_state_from_kwargs + + +@init_model_state_from_kwargs +class UpdateTemplateZipUploadConfigSourceDetails(UpdateTemplateConfigSourceDetails): + """ + Updates property details for the configuration .zip file. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateTemplateZipUploadConfigSourceDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.resource_manager.models.UpdateTemplateZipUploadConfigSourceDetails.template_config_source_type` attribute + of this class is ``ZIP_UPLOAD`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param template_config_source_type: + The value to assign to the template_config_source_type property of this UpdateTemplateZipUploadConfigSourceDetails. + :type template_config_source_type: str + + :param zip_file_base64_encoded: + The value to assign to the zip_file_base64_encoded property of this UpdateTemplateZipUploadConfigSourceDetails. + :type zip_file_base64_encoded: str + + """ + self.swagger_types = { + 'template_config_source_type': 'str', + 'zip_file_base64_encoded': 'str' + } + + self.attribute_map = { + 'template_config_source_type': 'templateConfigSourceType', + 'zip_file_base64_encoded': 'zipFileBase64Encoded' + } + + self._template_config_source_type = None + self._zip_file_base64_encoded = None + self._template_config_source_type = 'ZIP_UPLOAD' + + @property + def zip_file_base64_encoded(self): + """ + Gets the zip_file_base64_encoded of this UpdateTemplateZipUploadConfigSourceDetails. + + :return: The zip_file_base64_encoded of this UpdateTemplateZipUploadConfigSourceDetails. + :rtype: str + """ + return self._zip_file_base64_encoded + + @zip_file_base64_encoded.setter + def zip_file_base64_encoded(self, zip_file_base64_encoded): + """ + Sets the zip_file_base64_encoded of this UpdateTemplateZipUploadConfigSourceDetails. + + :param zip_file_base64_encoded: The zip_file_base64_encoded of this UpdateTemplateZipUploadConfigSourceDetails. + :type: str + """ + self._zip_file_base64_encoded = zip_file_base64_encoded + + def __repr__(self): + return formatted_flat_dict(self) + + def __eq__(self, other): + if other is None: + return False + + return self.__dict__ == other.__dict__ + + def __ne__(self, other): + return not self == other diff --git a/src/oci/resource_manager/resource_manager_client.py b/src/oci/resource_manager/resource_manager_client.py index ac7efdfc55..95d932b5bd 100644 --- a/src/oci/resource_manager/resource_manager_client.py +++ b/src/oci/resource_manager/resource_manager_client.py @@ -375,6 +375,109 @@ def change_stack_compartment(self, stack_id, change_stack_compartment_details, * header_params=header_params, body=change_stack_compartment_details) + def change_template_compartment(self, template_id, change_template_compartment_details, **kwargs): + """ + Moves a template into a different compartment within the same tenancy. + For information about moving resources between compartments, see + `Moving Resources to a Different Compartment`__. + + __ https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param oci.resource_manager.models.ChangeTemplateCompartmentDetails change_template_compartment_details: (required) + The details for moving a template to a different compartment. + + :param str if_match: (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. + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param str opc_retry_token: (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. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type None + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use change_template_compartment API. + """ + resource_path = "/templates/{templateId}/actions/changeCompartment" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "if_match", + "opc_request_id", + "opc_retry_token" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "change_template_compartment got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "templateId": template_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_template_compartment_details) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_template_compartment_details) + def create_configuration_source_provider(self, create_configuration_source_provider_details, **kwargs): """ Creates a configuration source provider in the specified compartment. @@ -617,6 +720,88 @@ def create_stack(self, create_stack_details, **kwargs): body=create_stack_details, response_type="Stack") + def create_template(self, create_template_details, **kwargs): + """ + Creates a custom template in the specified compartment. + + + :param oci.resource_manager.models.CreateTemplateDetails create_template_details: (required) + The configuration details for creating a template. + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param str opc_retry_token: (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. + + :param str oci_splat_generated_ocids: (optional) + This is to enable limit/quota support through splat + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.resource_manager.models.Template` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use create_template API. + """ + resource_path = "/templates" + method = "POST" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "opc_retry_token", + "oci_splat_generated_ocids" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "create_template got unknown kwargs: {!r}".format(extra_kwargs)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "opc-retry-token": kwargs.get("opc_retry_token", missing), + "oci-splat-generated-ocids": kwargs.get("oci_splat_generated_ocids", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_template_details, + response_type="Template") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_template_details, + response_type="Template") + def delete_configuration_source_provider(self, configuration_source_provider_id, **kwargs): """ Deletes the specified configuration source provider. @@ -783,6 +968,89 @@ def delete_stack(self, stack_id, **kwargs): path_params=path_params, header_params=header_params) + def delete_template(self, template_id, **kwargs): + """ + Deletes the specified template. + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param str if_match: (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. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type None + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use delete_template API. + """ + resource_path = "/templates/{templateId}" + method = "DELETE" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "if_match" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "delete_template got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "templateId": template_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params) + def detect_stack_drift(self, stack_id, **kwargs): """ Checks drift status for the specified stack. @@ -1605,9 +1873,245 @@ def get_stack_tf_state(self, stack_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_stack_tf_state API. + Click `here `__ to see an example of how to use get_stack_tf_state API. + """ + resource_path = "/stacks/{stackId}/tfState" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_stack_tf_state got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "stackId": stack_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/octet-stream", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="stream") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="stream") + + def get_template(self, template_id, **kwargs): + """ + Gets the specified template. + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.resource_manager.models.Template` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_template API. + """ + resource_path = "/templates/{templateId}" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_template got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "templateId": template_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Template") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Template") + + def get_template_logo(self, template_id, **kwargs): + """ + Returns the Terraform logo file in .logo format for the specified template. + Returns an error if no logo file is found. + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type stream + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_template_logo API. + """ + resource_path = "/templates/{templateId}/logo" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "get_template_logo got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "templateId": template_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "image/png", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="stream") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="stream") + + def get_template_tf_config(self, template_id, **kwargs): + """ + Returns the Terraform configuration file in .zip format for the specified template. + Returns an error if no zip file is found. + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type stream + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_template_tf_config API. """ - resource_path = "/stacks/{stackId}/tfState" + resource_path = "/templates/{templateId}/tfConfig" method = "GET" # Don't accept unknown kwargs @@ -1618,10 +2122,10 @@ def get_stack_tf_state(self, stack_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - "get_stack_tf_state got unknown kwargs: {!r}".format(extra_kwargs)) + "get_template_tf_config got unknown kwargs: {!r}".format(extra_kwargs)) path_params = { - "stackId": stack_id + "templateId": template_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1631,7 +2135,7 @@ def get_stack_tf_state(self, stack_id, **kwargs): raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) header_params = { - "accept": "application/octet-stream", + "accept": "application/zip", "content-type": "application/json", "opc-request-id": kwargs.get("opc_request_id", missing) } @@ -2401,6 +2905,204 @@ def list_stacks(self, **kwargs): header_params=header_params, response_type="list[StackSummary]") + def list_template_categories(self, **kwargs): + """ + Lists template categories. + + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.resource_manager.models.TemplateCategorySummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_template_categories API. + """ + resource_path = "/templateCategories" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_template_categories got unknown kwargs: {!r}".format(extra_kwargs)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + response_type="TemplateCategorySummaryCollection") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + response_type="TemplateCategorySummaryCollection") + + def list_templates(self, **kwargs): + """ + Lists templates according to the specified filter. + + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param str compartment_id: (optional) + A filter to return only resources that exist in the compartment, identified by `OCID`__. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str template_category_id: (optional) + Unique identifier of the template category. + + :param str template_id: (optional) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str display_name: (optional) + A filter to return only resources that match the specified display name. + + :param str sort_by: (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" + + :param str sort_order: (optional) + The sort order to use when sorting returned resources. Ascending (`ASC`) or descending (`DESC`). + + Allowed values are: "ASC", "DESC" + + :param int limit: (optional) + The number of items returned in a paginated `List` call. For information about pagination, see + `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine + + :param str page: (optional) + The value of the `opc-next-page` response header from the preceding `List` call. + For information about pagination, see `List Pagination`__. + + __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.resource_manager.models.TemplateSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_templates API. + """ + resource_path = "/templates" + method = "GET" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "compartment_id", + "template_category_id", + "template_id", + "display_name", + "sort_by", + "sort_order", + "limit", + "page" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "list_templates got unknown kwargs: {!r}".format(extra_kwargs)) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + "Invalid value for `sort_by`, must be one of {0}".format(sort_by_allowed_values) + ) + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + "Invalid value for `sort_order`, must be one of {0}".format(sort_order_allowed_values) + ) + + query_params = { + "compartmentId": kwargs.get("compartment_id", missing), + "templateCategoryId": kwargs.get("template_category_id", missing), + "templateId": kwargs.get("template_id", missing), + "displayName": kwargs.get("display_name", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) + } + query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="TemplateSummaryCollection") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="TemplateSummaryCollection") + def list_terraform_versions(self, **kwargs): """ Returns a list of supported Terraform versions for use with stacks. @@ -3094,3 +3796,93 @@ def update_stack(self, stack_id, update_stack_details, **kwargs): header_params=header_params, body=update_stack_details, response_type="Stack") + + def update_template(self, template_id, update_template_details, **kwargs): + """ + Updates the specified template. + + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param oci.resource_manager.models.UpdateTemplateDetails update_template_details: (required) + The details for updating a template. + + :param str opc_request_id: (optional) + Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a + particular request, please provide the request ID. + + :param str if_match: (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. + + :param obj retry_strategy: (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 :py:mod:`~oci.retry` module. A convenience :py:data:`~oci.retry.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 :py:class:`~oci.retry.NoneRetryStrategy`. + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.resource_manager.models.Template` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use update_template API. + """ + resource_path = "/templates/{templateId}" + method = "PUT" + + # Don't accept unknown kwargs + expected_kwargs = [ + "retry_strategy", + "opc_request_id", + "if_match" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + "update_template got unknown kwargs: {!r}".format(extra_kwargs)) + + path_params = { + "templateId": template_id + } + + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + + for (k, v) in six.iteritems(path_params): + if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): + raise ValueError('Parameter {} cannot be None, whitespace or empty string'.format(k)) + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-request-id": kwargs.get("opc_request_id", missing), + "if-match": kwargs.get("if_match", missing) + } + header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} + + retry_strategy = self.retry_strategy + if kwargs.get('retry_strategy'): + retry_strategy = kwargs.get('retry_strategy') + + if retry_strategy: + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_template_details, + response_type="Template") + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_template_details, + response_type="Template") diff --git a/src/oci/resource_manager/resource_manager_client_composite_operations.py b/src/oci/resource_manager/resource_manager_client_composite_operations.py index fa53ac8a8b..33a969517e 100644 --- a/src/oci/resource_manager/resource_manager_client_composite_operations.py +++ b/src/oci/resource_manager/resource_manager_client_composite_operations.py @@ -229,6 +229,44 @@ def create_stack_and_wait_for_state(self, create_stack_details, wait_for_states= except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def create_template_and_wait_for_state(self, create_template_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.resource_manager.ResourceManagerClient.create_template` and waits for the :py:class:`~oci.resource_manager.models.Template` acted upon + to enter the given state(s). + + :param oci.resource_manager.models.CreateTemplateDetails create_template_details: (required) + The configuration details for creating a template. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.resource_manager.models.Template.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.resource_manager.ResourceManagerClient.create_template` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.create_template(create_template_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_template(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def delete_configuration_source_provider_and_wait_for_state(self, configuration_source_provider_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.resource_manager.ResourceManagerClient.delete_configuration_source_provider` and waits for the :py:class:`~oci.resource_manager.models.ConfigurationSourceProvider` acted upon @@ -327,6 +365,55 @@ def delete_stack_and_wait_for_state(self, stack_id, wait_for_states=[], operatio except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def delete_template_and_wait_for_state(self, template_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.resource_manager.ResourceManagerClient.delete_template` and waits for the :py:class:`~oci.resource_manager.models.Template` acted upon + to enter the given state(s). + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.resource_manager.models.Template.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.resource_manager.ResourceManagerClient.delete_template` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + initial_get_result = self.client.get_template(template_id) + operation_result = None + try: + operation_result = self.client.delete_template(template_id, **operation_kwargs) + except oci.exceptions.ServiceError as e: + if e.status == 404: + return WAIT_RESOURCE_NOT_FOUND + else: + raise e + + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + + try: + waiter_result = oci.wait_until( + self.client, + initial_get_result, + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + succeed_on_not_found=True, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def detect_stack_drift_and_wait_for_state(self, stack_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.resource_manager.ResourceManagerClient.detect_stack_drift` and waits for the :py:class:`~oci.resource_manager.models.WorkRequest` @@ -495,3 +582,46 @@ def update_stack_and_wait_for_state(self, stack_id, update_stack_details, wait_f return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_template_and_wait_for_state(self, template_id, update_template_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.resource_manager.ResourceManagerClient.update_template` and waits for the :py:class:`~oci.resource_manager.models.Template` acted upon + to enter the given state(s). + + :param str template_id: (required) + The `OCID`__ of the template. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param oci.resource_manager.models.UpdateTemplateDetails update_template_details: (required) + The details for updating a template. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.resource_manager.models.Template.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.resource_manager.ResourceManagerClient.update_template` + + :param dict waiter_kwargs: + A dictionary of keyword arguments to pass to the :py:func:`oci.wait_until` function. For example, you could pass ``max_interval_seconds`` or ``max_interval_seconds`` + as dictionary keys to modify how long the waiter function will wait between retries and the maximum amount of time it will wait + """ + operation_result = self.client.update_template(template_id, update_template_details, **operation_kwargs) + if not wait_for_states: + return operation_result + + lowered_wait_for_states = [w.lower() for w in wait_for_states] + wait_for_resource_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_template(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, + **waiter_kwargs + ) + result_to_return = waiter_result + + return result_to_return + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) diff --git a/src/oci/version.py b/src/oci/version.py index 5505b20826..a706e96ca9 100644 --- a/src/oci/version.py +++ b/src/oci/version.py @@ -2,4 +2,4 @@ # Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved. # This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license. -__version__ = "2.29.0" +__version__ = "2.30.0"