diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 5adc7bfe9a..8df2ced17d 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -3,6 +3,35 @@ Change Log All notable changes to this project will be documented in this file. The format is based on `Keep a Changelog `_. +==================== +2.133.0 - 2024-08-27 +==================== + +Added +----- +* Support for Delegate Access Control service +* Support for upgrade and downgrade of shapes of high performance mount targets in the File Storage service +* Support for private endpoints in the Object Storage service +* Support for create, update, list and delete operations on scheduling policies and scheduling windows in the Database service +* Support for specifying domains while creating data guard associations in the Database service +* Support for provision of developer autonomous databases in the Database service +* Support for upgrade of developer autonomous databases to paid autonomous databases in the Database service +* Support for scheduling plans, actions, execution windows and execution actions for maintenance scheduling in the Database service +* Support for cross-region replication of virtual vaults in the Key Management service +* Support for listing all active service summaries in the Announcements service +* Support for VMware major and minor version upgrades in VMware Solution service +* Support for updating protected database subscriptions in the Autonomous Recovery service +* Support for health insurance id as an allowed document type in the Document Understanding service +* Support for advanced database management features for autonomous databases in the Database Management service +* Support for propagating request ids to load balancer servers in the Load balancer service +* Support for automatic update orders in Fusion Application as a Service + +Breaking +-------- +* Constant `DOCUMENT_TYPE_INSURANCE_CLAIM` was renamed to `DOCUMENT_TYPE_HEALTH_INSURANCE_ID` in models `AnalyzeDocumentDetails` and `GeneralProcessorConfig` in the Document Understanding service +* Property `document_id` was removed from model `DetectedDocumentType` in the Document Understanding service +* Property `tenancy_id` was removed from models `DocumentClassificationFeature` and `DocumentKeyValueExtractionFeature` in the Document Understanding service + ==================== 2.132.0 - 2024-08-20 ==================== diff --git a/docs/api/ai_document.rst b/docs/api/ai_document.rst index 4ef67499e6..2946771c03 100644 --- a/docs/api/ai_document.rst +++ b/docs/api/ai_document.rst @@ -18,6 +18,8 @@ Ai Document :nosignatures: :template: autosummary/model_class.rst + oci.ai_document.models.AddModelLockDetails + oci.ai_document.models.AddProjectLockDetails oci.ai_document.models.AnalyzeDocumentDetails oci.ai_document.models.AnalyzeDocumentResult oci.ai_document.models.BoundingPolygon @@ -79,6 +81,9 @@ Ai Document oci.ai_document.models.Project oci.ai_document.models.ProjectCollection oci.ai_document.models.ProjectSummary + oci.ai_document.models.RemoveModelLockDetails + oci.ai_document.models.RemoveProjectLockDetails + oci.ai_document.models.ResourceLock oci.ai_document.models.Table oci.ai_document.models.TableRow oci.ai_document.models.UpdateModelDetails diff --git a/docs/api/ai_document/models/oci.ai_document.models.AddModelLockDetails.rst b/docs/api/ai_document/models/oci.ai_document.models.AddModelLockDetails.rst new file mode 100644 index 0000000000..42c83040b0 --- /dev/null +++ b/docs/api/ai_document/models/oci.ai_document.models.AddModelLockDetails.rst @@ -0,0 +1,11 @@ +AddModelLockDetails +=================== + +.. currentmodule:: oci.ai_document.models + +.. autoclass:: AddModelLockDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/ai_document/models/oci.ai_document.models.AddProjectLockDetails.rst b/docs/api/ai_document/models/oci.ai_document.models.AddProjectLockDetails.rst new file mode 100644 index 0000000000..c59dde96b8 --- /dev/null +++ b/docs/api/ai_document/models/oci.ai_document.models.AddProjectLockDetails.rst @@ -0,0 +1,11 @@ +AddProjectLockDetails +===================== + +.. currentmodule:: oci.ai_document.models + +.. autoclass:: AddProjectLockDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/ai_document/models/oci.ai_document.models.RemoveModelLockDetails.rst b/docs/api/ai_document/models/oci.ai_document.models.RemoveModelLockDetails.rst new file mode 100644 index 0000000000..004c776d17 --- /dev/null +++ b/docs/api/ai_document/models/oci.ai_document.models.RemoveModelLockDetails.rst @@ -0,0 +1,11 @@ +RemoveModelLockDetails +====================== + +.. currentmodule:: oci.ai_document.models + +.. autoclass:: RemoveModelLockDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/ai_document/models/oci.ai_document.models.RemoveProjectLockDetails.rst b/docs/api/ai_document/models/oci.ai_document.models.RemoveProjectLockDetails.rst new file mode 100644 index 0000000000..f0bc2eed38 --- /dev/null +++ b/docs/api/ai_document/models/oci.ai_document.models.RemoveProjectLockDetails.rst @@ -0,0 +1,11 @@ +RemoveProjectLockDetails +======================== + +.. currentmodule:: oci.ai_document.models + +.. autoclass:: RemoveProjectLockDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/ai_document/models/oci.ai_document.models.ResourceLock.rst b/docs/api/ai_document/models/oci.ai_document.models.ResourceLock.rst new file mode 100644 index 0000000000..89f83fd4d7 --- /dev/null +++ b/docs/api/ai_document/models/oci.ai_document.models.ResourceLock.rst @@ -0,0 +1,11 @@ +ResourceLock +============ + +.. currentmodule:: oci.ai_document.models + +.. autoclass:: ResourceLock + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service.rst b/docs/api/announcements_service.rst index 8c158866fb..ec06a00199 100644 --- a/docs/api/announcements_service.rst +++ b/docs/api/announcements_service.rst @@ -9,9 +9,11 @@ Announcements Service oci.announcements_service.AnnouncementClient oci.announcements_service.AnnouncementSubscriptionClient oci.announcements_service.AnnouncementsPreferencesClient + oci.announcements_service.ServiceClient oci.announcements_service.AnnouncementClientCompositeOperations oci.announcements_service.AnnouncementSubscriptionClientCompositeOperations oci.announcements_service.AnnouncementsPreferencesClientCompositeOperations + oci.announcements_service.ServiceClientCompositeOperations -------- Models @@ -24,6 +26,7 @@ Announcements Service oci.announcements_service.models.AffectedResource oci.announcements_service.models.Announcement + oci.announcements_service.models.AnnouncementCompartment oci.announcements_service.models.AnnouncementSubscription oci.announcements_service.models.AnnouncementSubscriptionCollection oci.announcements_service.models.AnnouncementSubscriptionSummary @@ -35,6 +38,7 @@ Announcements Service oci.announcements_service.models.BaseAnnouncement oci.announcements_service.models.BaseAnnouncementsPreferences oci.announcements_service.models.BaseCreateAnnouncementsPreferencesDetails + oci.announcements_service.models.BaseService oci.announcements_service.models.ChangeAnnouncementSubscriptionCompartmentDetails oci.announcements_service.models.CreateAnnouncementSubscriptionDetails oci.announcements_service.models.CreateAnnouncementsPreferencesDetails @@ -43,6 +47,10 @@ Announcements Service oci.announcements_service.models.FilterGroup oci.announcements_service.models.FilterGroupDetails oci.announcements_service.models.ModelProperty + oci.announcements_service.models.NotificationsSummary + oci.announcements_service.models.Service + oci.announcements_service.models.ServiceSummary + oci.announcements_service.models.ServicesCollection oci.announcements_service.models.UpdateAnnouncementSubscriptionDetails oci.announcements_service.models.UpdateAnnouncementsPreferencesDetails oci.announcements_service.models.UpdateFilterGroupDetails diff --git a/docs/api/announcements_service/client/oci.announcements_service.ServiceClient.rst b/docs/api/announcements_service/client/oci.announcements_service.ServiceClient.rst new file mode 100644 index 0000000000..65852306ff --- /dev/null +++ b/docs/api/announcements_service/client/oci.announcements_service.ServiceClient.rst @@ -0,0 +1,8 @@ +ServiceClient +============= + +.. currentmodule:: oci.announcements_service + +.. autoclass:: ServiceClient + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/announcements_service/client/oci.announcements_service.ServiceClientCompositeOperations.rst b/docs/api/announcements_service/client/oci.announcements_service.ServiceClientCompositeOperations.rst new file mode 100644 index 0000000000..f9d945d358 --- /dev/null +++ b/docs/api/announcements_service/client/oci.announcements_service.ServiceClientCompositeOperations.rst @@ -0,0 +1,8 @@ +ServiceClientCompositeOperations +================================ + +.. currentmodule:: oci.announcements_service + +.. autoclass:: ServiceClientCompositeOperations + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.AnnouncementCompartment.rst b/docs/api/announcements_service/models/oci.announcements_service.models.AnnouncementCompartment.rst new file mode 100644 index 0000000000..b108abf7a2 --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.AnnouncementCompartment.rst @@ -0,0 +1,11 @@ +AnnouncementCompartment +======================= + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: AnnouncementCompartment + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.BaseService.rst b/docs/api/announcements_service/models/oci.announcements_service.models.BaseService.rst new file mode 100644 index 0000000000..cb783ebc1c --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.BaseService.rst @@ -0,0 +1,11 @@ +BaseService +=========== + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: BaseService + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.NotificationsSummary.rst b/docs/api/announcements_service/models/oci.announcements_service.models.NotificationsSummary.rst new file mode 100644 index 0000000000..2318dee2b6 --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.NotificationsSummary.rst @@ -0,0 +1,11 @@ +NotificationsSummary +==================== + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: NotificationsSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.Service.rst b/docs/api/announcements_service/models/oci.announcements_service.models.Service.rst new file mode 100644 index 0000000000..175792d8bb --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.Service.rst @@ -0,0 +1,11 @@ +Service +======= + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: Service + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.ServiceSummary.rst b/docs/api/announcements_service/models/oci.announcements_service.models.ServiceSummary.rst new file mode 100644 index 0000000000..2d8da667f6 --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.ServiceSummary.rst @@ -0,0 +1,11 @@ +ServiceSummary +============== + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: ServiceSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/announcements_service/models/oci.announcements_service.models.ServicesCollection.rst b/docs/api/announcements_service/models/oci.announcements_service.models.ServicesCollection.rst new file mode 100644 index 0000000000..277e70cc8e --- /dev/null +++ b/docs/api/announcements_service/models/oci.announcements_service.models.ServicesCollection.rst @@ -0,0 +1,11 @@ +ServicesCollection +================== + +.. currentmodule:: oci.announcements_service.models + +.. autoclass:: ServicesCollection + :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 e9dfa7eac6..0140fe47c7 100644 --- a/docs/api/database.rst +++ b/docs/api/database.rst @@ -19,6 +19,10 @@ Database :template: autosummary/model_class.rst oci.database.models.AcdAvmResourceStats + oci.database.models.ActionMember + oci.database.models.ActionOrderDetails + oci.database.models.ActionParamValuesCollection + oci.database.models.ActionParamValuesSummary oci.database.models.ActivateExadataInfrastructureDetails oci.database.models.AddVirtualMachineToCloudVmClusterDetails oci.database.models.AddVirtualMachineToVmClusterDetails @@ -76,6 +80,7 @@ Database oci.database.models.BackupDestinationDetails oci.database.models.BackupDestinationSummary oci.database.models.BackupSummary + oci.database.models.CancelExecutionWindowDetails oci.database.models.ChangeAutonomousDatabaseSoftwareImageCompartmentDetails oci.database.models.ChangeAutonomousDatabaseSubscriptionDetails oci.database.models.ChangeAutonomousVmClusterCompartmentDetails @@ -92,6 +97,8 @@ Database oci.database.models.ChangeExascaleDbStorageVaultCompartmentDetails oci.database.models.ChangeKeyStoreCompartmentDetails oci.database.models.ChangeKeyStoreTypeDetails + oci.database.models.ChangeSchedulingPlanCompartmentDetails + oci.database.models.ChangeSchedulingPolicyCompartmentDetails oci.database.models.ChangeSubscriptionDetails oci.database.models.ChangeVmClusterCompartmentDetails oci.database.models.CloudAutomationApplyUpdateTimePreference @@ -165,6 +172,8 @@ Database oci.database.models.CreateExadataInfrastructureDetails oci.database.models.CreateExadbVmClusterDetails oci.database.models.CreateExascaleDbStorageVaultDetails + oci.database.models.CreateExecutionActionDetails + oci.database.models.CreateExecutionWindowDetails oci.database.models.CreateExternalBackupJobDetails oci.database.models.CreateExternalContainerDatabaseDetails oci.database.models.CreateExternalDatabaseConnectorDetails @@ -185,6 +194,10 @@ Database oci.database.models.CreatePluggableDatabaseRefreshableCloneDetails oci.database.models.CreateRecoveryApplianceBackupDestinationDetails oci.database.models.CreateRefreshableAutonomousDatabaseCloneDetails + oci.database.models.CreateScheduledActionDetails + oci.database.models.CreateSchedulingPlanDetails + oci.database.models.CreateSchedulingPolicyDetails + oci.database.models.CreateSchedulingWindowDetails oci.database.models.CreateVmClusterDetails oci.database.models.CustomerContact oci.database.models.DataCollectionOptions @@ -273,6 +286,11 @@ Database oci.database.models.ExascaleDbStorageInputDetails oci.database.models.ExascaleDbStorageVault oci.database.models.ExascaleDbStorageVaultSummary + oci.database.models.ExecutionAction + oci.database.models.ExecutionActionMember + oci.database.models.ExecutionActionSummary + oci.database.models.ExecutionWindow + oci.database.models.ExecutionWindowSummary oci.database.models.ExternalBackupJob oci.database.models.ExternalContainerDatabase oci.database.models.ExternalContainerDatabaseSummary @@ -293,6 +311,7 @@ Database oci.database.models.GenerateRecommendedNetworkDetails oci.database.models.GiMinorVersionSummary oci.database.models.GiVersionSummary + oci.database.models.GranularMaintenanceHistoryDetails oci.database.models.InfoForNetworkGenDetails oci.database.models.InfrastructureTargetVersion oci.database.models.InfrastructureTargetVersionSummary @@ -319,6 +338,7 @@ Database oci.database.models.ModifyPluggableDatabaseManagementDetails oci.database.models.Month oci.database.models.MountTypeDetails + oci.database.models.MoveExecutionActionMemberDetails oci.database.models.NetworkBondingModeDetails oci.database.models.NodeDetails oci.database.models.OCPUs @@ -340,6 +360,8 @@ Database oci.database.models.PluggableDatabaseNodeLevelDetails oci.database.models.PluggableDatabaseRefreshableCloneConfig oci.database.models.PluggableDatabaseSummary + oci.database.models.RecommendedScheduledActionSummary + oci.database.models.RecommendedScheduledActionsCollection oci.database.models.RefreshableCloneCollection oci.database.models.RefreshableCloneSummary oci.database.models.RegisterAutonomousDatabaseDataSafeDetails @@ -348,6 +370,8 @@ Database oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails oci.database.models.RemoveVirtualMachineFromVmClusterDetails + oci.database.models.ReorderExecutionActionDetails + oci.database.models.ReorderScheduledActionsDetails oci.database.models.ResizeVmClusterNetworkDetails oci.database.models.ResourcePoolShapeCollection oci.database.models.ResourcePoolShapeSummary @@ -361,7 +385,17 @@ Database oci.database.models.SaasAdminUserConfiguration oci.database.models.SaasAdminUserStatus oci.database.models.ScanDetails + oci.database.models.ScheduledAction + oci.database.models.ScheduledActionCollection + oci.database.models.ScheduledActionSummary oci.database.models.ScheduledOperationDetails + oci.database.models.SchedulingPlan + oci.database.models.SchedulingPlanCollection + oci.database.models.SchedulingPlanSummary + oci.database.models.SchedulingPolicy + oci.database.models.SchedulingPolicySummary + oci.database.models.SchedulingWindow + oci.database.models.SchedulingWindowSummary oci.database.models.SelfMountDetails oci.database.models.StackMonitoringConfig oci.database.models.StoragePerformanceDetails @@ -393,6 +427,8 @@ Database oci.database.models.UpdateExadataInfrastructureDetails oci.database.models.UpdateExadbVmClusterDetails oci.database.models.UpdateExascaleDbStorageVaultDetails + oci.database.models.UpdateExecutionActionDetails + oci.database.models.UpdateExecutionWindowDetails oci.database.models.UpdateExternalContainerDatabaseDetails oci.database.models.UpdateExternalDatabaseConnectorDetails oci.database.models.UpdateExternalDatabaseDetailsBase @@ -405,6 +441,9 @@ Database oci.database.models.UpdateMaintenanceRunDetails oci.database.models.UpdateOneoffPatchDetails oci.database.models.UpdatePluggableDatabaseDetails + oci.database.models.UpdateScheduledActionDetails + oci.database.models.UpdateSchedulingPolicyDetails + oci.database.models.UpdateSchedulingWindowDetails oci.database.models.UpdateSummary oci.database.models.UpdateVmClusterDetails oci.database.models.UpdateVmClusterNetworkDetails @@ -421,4 +460,5 @@ Database oci.database.models.VmClusterUpdateHistoryEntrySummary oci.database.models.VmClusterUpdateSummary oci.database.models.VmNetworkDetails + oci.database.models.WindowPreferenceDetail oci.database.models.WorkloadType diff --git a/docs/api/database/models/oci.database.models.ActionMember.rst b/docs/api/database/models/oci.database.models.ActionMember.rst new file mode 100644 index 0000000000..4850b9c50b --- /dev/null +++ b/docs/api/database/models/oci.database.models.ActionMember.rst @@ -0,0 +1,11 @@ +ActionMember +============ + +.. currentmodule:: oci.database.models + +.. autoclass:: ActionMember + :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.ActionOrderDetails.rst b/docs/api/database/models/oci.database.models.ActionOrderDetails.rst new file mode 100644 index 0000000000..bd425dbbd5 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ActionOrderDetails.rst @@ -0,0 +1,11 @@ +ActionOrderDetails +================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ActionOrderDetails + :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.ActionParamValuesCollection.rst b/docs/api/database/models/oci.database.models.ActionParamValuesCollection.rst new file mode 100644 index 0000000000..193d6cbedf --- /dev/null +++ b/docs/api/database/models/oci.database.models.ActionParamValuesCollection.rst @@ -0,0 +1,11 @@ +ActionParamValuesCollection +=========================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ActionParamValuesCollection + :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.ActionParamValuesSummary.rst b/docs/api/database/models/oci.database.models.ActionParamValuesSummary.rst new file mode 100644 index 0000000000..a43671e5e9 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ActionParamValuesSummary.rst @@ -0,0 +1,11 @@ +ActionParamValuesSummary +======================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ActionParamValuesSummary + :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.CancelExecutionWindowDetails.rst b/docs/api/database/models/oci.database.models.CancelExecutionWindowDetails.rst new file mode 100644 index 0000000000..64db49787f --- /dev/null +++ b/docs/api/database/models/oci.database.models.CancelExecutionWindowDetails.rst @@ -0,0 +1,11 @@ +CancelExecutionWindowDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: CancelExecutionWindowDetails + :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.ChangeSchedulingPlanCompartmentDetails.rst b/docs/api/database/models/oci.database.models.ChangeSchedulingPlanCompartmentDetails.rst new file mode 100644 index 0000000000..6052733ac1 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ChangeSchedulingPlanCompartmentDetails.rst @@ -0,0 +1,11 @@ +ChangeSchedulingPlanCompartmentDetails +====================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ChangeSchedulingPlanCompartmentDetails + :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.ChangeSchedulingPolicyCompartmentDetails.rst b/docs/api/database/models/oci.database.models.ChangeSchedulingPolicyCompartmentDetails.rst new file mode 100644 index 0000000000..8de2ac2c50 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ChangeSchedulingPolicyCompartmentDetails.rst @@ -0,0 +1,11 @@ +ChangeSchedulingPolicyCompartmentDetails +======================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ChangeSchedulingPolicyCompartmentDetails + :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.CreateExecutionActionDetails.rst b/docs/api/database/models/oci.database.models.CreateExecutionActionDetails.rst new file mode 100644 index 0000000000..8e2d8f4994 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExecutionActionDetails.rst @@ -0,0 +1,11 @@ +CreateExecutionActionDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExecutionActionDetails + :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.CreateExecutionWindowDetails.rst b/docs/api/database/models/oci.database.models.CreateExecutionWindowDetails.rst new file mode 100644 index 0000000000..fb37633275 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateExecutionWindowDetails.rst @@ -0,0 +1,11 @@ +CreateExecutionWindowDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateExecutionWindowDetails + :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.CreateScheduledActionDetails.rst b/docs/api/database/models/oci.database.models.CreateScheduledActionDetails.rst new file mode 100644 index 0000000000..f2661eb9fa --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateScheduledActionDetails.rst @@ -0,0 +1,11 @@ +CreateScheduledActionDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateScheduledActionDetails + :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.CreateSchedulingPlanDetails.rst b/docs/api/database/models/oci.database.models.CreateSchedulingPlanDetails.rst new file mode 100644 index 0000000000..3004b4f25a --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateSchedulingPlanDetails.rst @@ -0,0 +1,11 @@ +CreateSchedulingPlanDetails +=========================== + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateSchedulingPlanDetails + :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.CreateSchedulingPolicyDetails.rst b/docs/api/database/models/oci.database.models.CreateSchedulingPolicyDetails.rst new file mode 100644 index 0000000000..411e474bee --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateSchedulingPolicyDetails.rst @@ -0,0 +1,11 @@ +CreateSchedulingPolicyDetails +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateSchedulingPolicyDetails + :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.CreateSchedulingWindowDetails.rst b/docs/api/database/models/oci.database.models.CreateSchedulingWindowDetails.rst new file mode 100644 index 0000000000..70906a72a3 --- /dev/null +++ b/docs/api/database/models/oci.database.models.CreateSchedulingWindowDetails.rst @@ -0,0 +1,11 @@ +CreateSchedulingWindowDetails +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: CreateSchedulingWindowDetails + :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.ExecutionAction.rst b/docs/api/database/models/oci.database.models.ExecutionAction.rst new file mode 100644 index 0000000000..a90b851bce --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExecutionAction.rst @@ -0,0 +1,11 @@ +ExecutionAction +=============== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExecutionAction + :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.ExecutionActionMember.rst b/docs/api/database/models/oci.database.models.ExecutionActionMember.rst new file mode 100644 index 0000000000..f6454bfaba --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExecutionActionMember.rst @@ -0,0 +1,11 @@ +ExecutionActionMember +===================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExecutionActionMember + :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.ExecutionActionSummary.rst b/docs/api/database/models/oci.database.models.ExecutionActionSummary.rst new file mode 100644 index 0000000000..25891eb199 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExecutionActionSummary.rst @@ -0,0 +1,11 @@ +ExecutionActionSummary +====================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExecutionActionSummary + :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.ExecutionWindow.rst b/docs/api/database/models/oci.database.models.ExecutionWindow.rst new file mode 100644 index 0000000000..0fee11baf1 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExecutionWindow.rst @@ -0,0 +1,11 @@ +ExecutionWindow +=============== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExecutionWindow + :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.ExecutionWindowSummary.rst b/docs/api/database/models/oci.database.models.ExecutionWindowSummary.rst new file mode 100644 index 0000000000..976f357739 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ExecutionWindowSummary.rst @@ -0,0 +1,11 @@ +ExecutionWindowSummary +====================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ExecutionWindowSummary + :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.GranularMaintenanceHistoryDetails.rst b/docs/api/database/models/oci.database.models.GranularMaintenanceHistoryDetails.rst new file mode 100644 index 0000000000..b91b23e87c --- /dev/null +++ b/docs/api/database/models/oci.database.models.GranularMaintenanceHistoryDetails.rst @@ -0,0 +1,11 @@ +GranularMaintenanceHistoryDetails +================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: GranularMaintenanceHistoryDetails + :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.MoveExecutionActionMemberDetails.rst b/docs/api/database/models/oci.database.models.MoveExecutionActionMemberDetails.rst new file mode 100644 index 0000000000..34d61c4335 --- /dev/null +++ b/docs/api/database/models/oci.database.models.MoveExecutionActionMemberDetails.rst @@ -0,0 +1,11 @@ +MoveExecutionActionMemberDetails +================================ + +.. currentmodule:: oci.database.models + +.. autoclass:: MoveExecutionActionMemberDetails + :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.RecommendedScheduledActionSummary.rst b/docs/api/database/models/oci.database.models.RecommendedScheduledActionSummary.rst new file mode 100644 index 0000000000..ef08fe51c9 --- /dev/null +++ b/docs/api/database/models/oci.database.models.RecommendedScheduledActionSummary.rst @@ -0,0 +1,11 @@ +RecommendedScheduledActionSummary +================================= + +.. currentmodule:: oci.database.models + +.. autoclass:: RecommendedScheduledActionSummary + :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.RecommendedScheduledActionsCollection.rst b/docs/api/database/models/oci.database.models.RecommendedScheduledActionsCollection.rst new file mode 100644 index 0000000000..9314a1a936 --- /dev/null +++ b/docs/api/database/models/oci.database.models.RecommendedScheduledActionsCollection.rst @@ -0,0 +1,11 @@ +RecommendedScheduledActionsCollection +===================================== + +.. currentmodule:: oci.database.models + +.. autoclass:: RecommendedScheduledActionsCollection + :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.ReorderExecutionActionDetails.rst b/docs/api/database/models/oci.database.models.ReorderExecutionActionDetails.rst new file mode 100644 index 0000000000..65a3719546 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ReorderExecutionActionDetails.rst @@ -0,0 +1,11 @@ +ReorderExecutionActionDetails +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: ReorderExecutionActionDetails + :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.ReorderScheduledActionsDetails.rst b/docs/api/database/models/oci.database.models.ReorderScheduledActionsDetails.rst new file mode 100644 index 0000000000..2e92eaab7d --- /dev/null +++ b/docs/api/database/models/oci.database.models.ReorderScheduledActionsDetails.rst @@ -0,0 +1,11 @@ +ReorderScheduledActionsDetails +============================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ReorderScheduledActionsDetails + :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.ScheduledAction.rst b/docs/api/database/models/oci.database.models.ScheduledAction.rst new file mode 100644 index 0000000000..6e981e5557 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ScheduledAction.rst @@ -0,0 +1,11 @@ +ScheduledAction +=============== + +.. currentmodule:: oci.database.models + +.. autoclass:: ScheduledAction + :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.ScheduledActionCollection.rst b/docs/api/database/models/oci.database.models.ScheduledActionCollection.rst new file mode 100644 index 0000000000..e8e925d2c2 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ScheduledActionCollection.rst @@ -0,0 +1,11 @@ +ScheduledActionCollection +========================= + +.. currentmodule:: oci.database.models + +.. autoclass:: ScheduledActionCollection + :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.ScheduledActionSummary.rst b/docs/api/database/models/oci.database.models.ScheduledActionSummary.rst new file mode 100644 index 0000000000..3ccbde3b38 --- /dev/null +++ b/docs/api/database/models/oci.database.models.ScheduledActionSummary.rst @@ -0,0 +1,11 @@ +ScheduledActionSummary +====================== + +.. currentmodule:: oci.database.models + +.. autoclass:: ScheduledActionSummary + :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.SchedulingPlan.rst b/docs/api/database/models/oci.database.models.SchedulingPlan.rst new file mode 100644 index 0000000000..5116415db1 --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingPlan.rst @@ -0,0 +1,11 @@ +SchedulingPlan +============== + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingPlan + :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.SchedulingPlanCollection.rst b/docs/api/database/models/oci.database.models.SchedulingPlanCollection.rst new file mode 100644 index 0000000000..3e47b1bfbe --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingPlanCollection.rst @@ -0,0 +1,11 @@ +SchedulingPlanCollection +======================== + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingPlanCollection + :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.SchedulingPlanSummary.rst b/docs/api/database/models/oci.database.models.SchedulingPlanSummary.rst new file mode 100644 index 0000000000..346b929481 --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingPlanSummary.rst @@ -0,0 +1,11 @@ +SchedulingPlanSummary +===================== + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingPlanSummary + :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.SchedulingPolicy.rst b/docs/api/database/models/oci.database.models.SchedulingPolicy.rst new file mode 100644 index 0000000000..99b2dd4719 --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingPolicy.rst @@ -0,0 +1,11 @@ +SchedulingPolicy +================ + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingPolicy + :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.SchedulingPolicySummary.rst b/docs/api/database/models/oci.database.models.SchedulingPolicySummary.rst new file mode 100644 index 0000000000..a4ed936f3b --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingPolicySummary.rst @@ -0,0 +1,11 @@ +SchedulingPolicySummary +======================= + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingPolicySummary + :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.SchedulingWindow.rst b/docs/api/database/models/oci.database.models.SchedulingWindow.rst new file mode 100644 index 0000000000..8cf8c7d21f --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingWindow.rst @@ -0,0 +1,11 @@ +SchedulingWindow +================ + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingWindow + :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.SchedulingWindowSummary.rst b/docs/api/database/models/oci.database.models.SchedulingWindowSummary.rst new file mode 100644 index 0000000000..bb6ac7f2c8 --- /dev/null +++ b/docs/api/database/models/oci.database.models.SchedulingWindowSummary.rst @@ -0,0 +1,11 @@ +SchedulingWindowSummary +======================= + +.. currentmodule:: oci.database.models + +.. autoclass:: SchedulingWindowSummary + :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.UpdateExecutionActionDetails.rst b/docs/api/database/models/oci.database.models.UpdateExecutionActionDetails.rst new file mode 100644 index 0000000000..dcbe09dd2e --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExecutionActionDetails.rst @@ -0,0 +1,11 @@ +UpdateExecutionActionDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExecutionActionDetails + :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.UpdateExecutionWindowDetails.rst b/docs/api/database/models/oci.database.models.UpdateExecutionWindowDetails.rst new file mode 100644 index 0000000000..a2563e1bb9 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateExecutionWindowDetails.rst @@ -0,0 +1,11 @@ +UpdateExecutionWindowDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateExecutionWindowDetails + :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.UpdateScheduledActionDetails.rst b/docs/api/database/models/oci.database.models.UpdateScheduledActionDetails.rst new file mode 100644 index 0000000000..b7897ef0c8 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateScheduledActionDetails.rst @@ -0,0 +1,11 @@ +UpdateScheduledActionDetails +============================ + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateScheduledActionDetails + :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.UpdateSchedulingPolicyDetails.rst b/docs/api/database/models/oci.database.models.UpdateSchedulingPolicyDetails.rst new file mode 100644 index 0000000000..00cf4f22f0 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateSchedulingPolicyDetails.rst @@ -0,0 +1,11 @@ +UpdateSchedulingPolicyDetails +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateSchedulingPolicyDetails + :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.UpdateSchedulingWindowDetails.rst b/docs/api/database/models/oci.database.models.UpdateSchedulingWindowDetails.rst new file mode 100644 index 0000000000..f09819e197 --- /dev/null +++ b/docs/api/database/models/oci.database.models.UpdateSchedulingWindowDetails.rst @@ -0,0 +1,11 @@ +UpdateSchedulingWindowDetails +============================= + +.. currentmodule:: oci.database.models + +.. autoclass:: UpdateSchedulingWindowDetails + :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.WindowPreferenceDetail.rst b/docs/api/database/models/oci.database.models.WindowPreferenceDetail.rst new file mode 100644 index 0000000000..c3a5e2d772 --- /dev/null +++ b/docs/api/database/models/oci.database.models.WindowPreferenceDetail.rst @@ -0,0 +1,11 @@ +WindowPreferenceDetail +====================== + +.. currentmodule:: oci.database.models + +.. autoclass:: WindowPreferenceDetail + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management.rst b/docs/api/database_management.rst index 51b0b92072..a4e9466724 100644 --- a/docs/api/database_management.rst +++ b/docs/api/database_management.rst @@ -54,6 +54,9 @@ Database Management oci.database_management.models.AttentionLogSummary oci.database_management.models.AutomaticCaptureFilter oci.database_management.models.AutomaticCaptureFilterDetails + oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails + oci.database_management.models.AutonomousDatabaseFeatureDetails + oci.database_management.models.AutonomousDatabaseSqlWatchFeatureDetails oci.database_management.models.AwrDbCollection oci.database_management.models.AwrDbCpuUsageCollection oci.database_management.models.AwrDbCpuUsageSummary @@ -162,8 +165,10 @@ Database Management oci.database_management.models.DbManagementPrivateEndpointCollection oci.database_management.models.DbManagementPrivateEndpointSummary oci.database_management.models.DbmResource + oci.database_management.models.DirectConnectorDetails oci.database_management.models.DisableAutomaticInitialPlanCaptureDetails oci.database_management.models.DisableAutomaticSpmEvolveAdvisorTaskDetails + oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails oci.database_management.models.DisableDatabaseManagementFeatureDetails oci.database_management.models.DisableExternalContainerDatabaseManagementFeatureDetails oci.database_management.models.DisableExternalNonContainerDatabaseManagementFeatureDetails @@ -189,6 +194,7 @@ Database Management oci.database_management.models.DropTablespaceDetails oci.database_management.models.EnableAutomaticInitialPlanCaptureDetails oci.database_management.models.EnableAutomaticSpmEvolveAdvisorTaskDetails + oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails oci.database_management.models.EnableDatabaseManagementFeatureDetails oci.database_management.models.EnableExternalContainerDatabaseManagementFeatureDetails oci.database_management.models.EnableExternalDbSystemDatabaseManagementDetails @@ -350,6 +356,7 @@ Database Management oci.database_management.models.MetricStatisticsDefinition oci.database_management.models.MetricsAggregationRange oci.database_management.models.MetricsAggregationRangeCollection + oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails oci.database_management.models.ModifyDatabaseManagementFeatureDetails oci.database_management.models.ModifyPluggableDatabaseManagementFeatureDetails oci.database_management.models.ModifySnapshotSettingsDetails diff --git a/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails.rst new file mode 100644 index 0000000000..7936db5f83 --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails.rst @@ -0,0 +1,11 @@ +AutonomousDatabaseDiagnosticsAndManagementFeatureDetails +======================================================== + +.. currentmodule:: oci.database_management.models + +.. autoclass:: AutonomousDatabaseDiagnosticsAndManagementFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseFeatureDetails.rst new file mode 100644 index 0000000000..c0d241b763 --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseFeatureDetails.rst @@ -0,0 +1,11 @@ +AutonomousDatabaseFeatureDetails +================================ + +.. currentmodule:: oci.database_management.models + +.. autoclass:: AutonomousDatabaseFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseSqlWatchFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseSqlWatchFeatureDetails.rst new file mode 100644 index 0000000000..5b486d2eee --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.AutonomousDatabaseSqlWatchFeatureDetails.rst @@ -0,0 +1,11 @@ +AutonomousDatabaseSqlWatchFeatureDetails +======================================== + +.. currentmodule:: oci.database_management.models + +.. autoclass:: AutonomousDatabaseSqlWatchFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.DirectConnectorDetails.rst b/docs/api/database_management/models/oci.database_management.models.DirectConnectorDetails.rst new file mode 100644 index 0000000000..b54601a00a --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.DirectConnectorDetails.rst @@ -0,0 +1,11 @@ +DirectConnectorDetails +====================== + +.. currentmodule:: oci.database_management.models + +.. autoclass:: DirectConnectorDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails.rst new file mode 100644 index 0000000000..93f1d915a7 --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails.rst @@ -0,0 +1,11 @@ +DisableAutonomousDatabaseManagementFeatureDetails +================================================= + +.. currentmodule:: oci.database_management.models + +.. autoclass:: DisableAutonomousDatabaseManagementFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails.rst new file mode 100644 index 0000000000..1d5363bb62 --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails.rst @@ -0,0 +1,11 @@ +EnableAutonomousDatabaseManagementFeatureDetails +================================================ + +.. currentmodule:: oci.database_management.models + +.. autoclass:: EnableAutonomousDatabaseManagementFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/database_management/models/oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails.rst b/docs/api/database_management/models/oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails.rst new file mode 100644 index 0000000000..4f730e49c3 --- /dev/null +++ b/docs/api/database_management/models/oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails.rst @@ -0,0 +1,11 @@ +ModifyAutonomousDatabaseManagementFeatureDetails +================================================ + +.. currentmodule:: oci.database_management.models + +.. autoclass:: ModifyAutonomousDatabaseManagementFeatureDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control.rst b/docs/api/delegate_access_control.rst new file mode 100644 index 0000000000..4f0beaf1d6 --- /dev/null +++ b/docs/api/delegate_access_control.rst @@ -0,0 +1,64 @@ +Delegate Access Control +======================= + +.. autosummary:: + :toctree: delegate_access_control/client + :nosignatures: + :template: autosummary/service_client.rst + + oci.delegate_access_control.DelegateAccessControlClient + oci.delegate_access_control.WorkRequestClient + oci.delegate_access_control.DelegateAccessControlClientCompositeOperations + oci.delegate_access_control.WorkRequestClientCompositeOperations + +-------- + Models +-------- + +.. autosummary:: + :toctree: delegate_access_control/models + :nosignatures: + :template: autosummary/model_class.rst + + oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails + oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails + oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails + oci.delegate_access_control.models.CreateDelegationControlDetails + oci.delegate_access_control.models.CreateDelegationSubscriptionDetails + oci.delegate_access_control.models.DelegatedResourceAccessRequest + oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails + oci.delegate_access_control.models.DelegatedResourceAccessRequestAuditLogReport + oci.delegate_access_control.models.DelegatedResourceAccessRequestHistoryCollection + oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary + oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary + oci.delegate_access_control.models.DelegatedResourceAccessRequestSummaryCollection + oci.delegate_access_control.models.DelegationControl + oci.delegate_access_control.models.DelegationControlResourceCollection + oci.delegate_access_control.models.DelegationControlResourceSummary + oci.delegate_access_control.models.DelegationControlSummary + oci.delegate_access_control.models.DelegationControlSummaryCollection + oci.delegate_access_control.models.DelegationSubscription + oci.delegate_access_control.models.DelegationSubscriptionSummary + oci.delegate_access_control.models.DelegationSubscriptionSummaryCollection + oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails + oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails + oci.delegate_access_control.models.ServiceProvider + oci.delegate_access_control.models.ServiceProviderAction + oci.delegate_access_control.models.ServiceProviderActionProperties + oci.delegate_access_control.models.ServiceProviderActionSummary + oci.delegate_access_control.models.ServiceProviderActionSummaryCollection + oci.delegate_access_control.models.ServiceProviderInteractionCollection + oci.delegate_access_control.models.ServiceProviderInteractionRequestDetails + oci.delegate_access_control.models.ServiceProviderInteractionSummary + oci.delegate_access_control.models.ServiceProviderSummary + oci.delegate_access_control.models.ServiceProviderSummaryCollection + oci.delegate_access_control.models.UpdateDelegationControlDetails + oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails + oci.delegate_access_control.models.WorkRequest + oci.delegate_access_control.models.WorkRequestError + oci.delegate_access_control.models.WorkRequestErrorCollection + oci.delegate_access_control.models.WorkRequestLogEntry + oci.delegate_access_control.models.WorkRequestLogEntryCollection + oci.delegate_access_control.models.WorkRequestResource + oci.delegate_access_control.models.WorkRequestSummary + oci.delegate_access_control.models.WorkRequestSummaryCollection diff --git a/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClient.rst b/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClient.rst new file mode 100644 index 0000000000..b1a00eb508 --- /dev/null +++ b/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClient.rst @@ -0,0 +1,8 @@ +DelegateAccessControlClient +=========================== + +.. currentmodule:: oci.delegate_access_control + +.. autoclass:: DelegateAccessControlClient + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClientCompositeOperations.rst b/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClientCompositeOperations.rst new file mode 100644 index 0000000000..ab55019f95 --- /dev/null +++ b/docs/api/delegate_access_control/client/oci.delegate_access_control.DelegateAccessControlClientCompositeOperations.rst @@ -0,0 +1,8 @@ +DelegateAccessControlClientCompositeOperations +============================================== + +.. currentmodule:: oci.delegate_access_control + +.. autoclass:: DelegateAccessControlClientCompositeOperations + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClient.rst b/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClient.rst new file mode 100644 index 0000000000..0494932d03 --- /dev/null +++ b/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClient.rst @@ -0,0 +1,8 @@ +WorkRequestClient +================= + +.. currentmodule:: oci.delegate_access_control + +.. autoclass:: WorkRequestClient + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClientCompositeOperations.rst b/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClientCompositeOperations.rst new file mode 100644 index 0000000000..832168390b --- /dev/null +++ b/docs/api/delegate_access_control/client/oci.delegate_access_control.WorkRequestClientCompositeOperations.rst @@ -0,0 +1,8 @@ +WorkRequestClientCompositeOperations +==================================== + +.. currentmodule:: oci.delegate_access_control + +.. autoclass:: WorkRequestClientCompositeOperations + :special-members: __init__ + :members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails.rst new file mode 100644 index 0000000000..fc4a37dae4 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails.rst @@ -0,0 +1,11 @@ +ApproveDelegatedResourceAccessRequestDetails +============================================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ApproveDelegatedResourceAccessRequestDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails.rst new file mode 100644 index 0000000000..35d849d45a --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails.rst @@ -0,0 +1,11 @@ +ChangeDelegationControlCompartmentDetails +========================================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ChangeDelegationControlCompartmentDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails.rst new file mode 100644 index 0000000000..1808da6b7e --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails.rst @@ -0,0 +1,11 @@ +ChangeDelegationSubscriptionCompartmentDetails +============================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ChangeDelegationSubscriptionCompartmentDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationControlDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationControlDetails.rst new file mode 100644 index 0000000000..54135d3ae7 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationControlDetails.rst @@ -0,0 +1,11 @@ +CreateDelegationControlDetails +============================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: CreateDelegationControlDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationSubscriptionDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationSubscriptionDetails.rst new file mode 100644 index 0000000000..fce5e2a2ae --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.CreateDelegationSubscriptionDetails.rst @@ -0,0 +1,11 @@ +CreateDelegationSubscriptionDetails +=================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: CreateDelegationSubscriptionDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequest.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequest.rst new file mode 100644 index 0000000000..73c203f19e --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequest.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequest +============================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequest + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails.rst new file mode 100644 index 0000000000..f4cf1073c2 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestApprovalDetails +============================================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestApprovalDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestAuditLogReport.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestAuditLogReport.rst new file mode 100644 index 0000000000..e5c42bb3e8 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestAuditLogReport.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestAuditLogReport +============================================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestAuditLogReport + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistoryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistoryCollection.rst new file mode 100644 index 0000000000..45b3d19222 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistoryCollection.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestHistoryCollection +=============================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestHistoryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary.rst new file mode 100644 index 0000000000..7fe609d1f1 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestHistorySummary +============================================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestHistorySummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary.rst new file mode 100644 index 0000000000..cabd292a89 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestSummary +===================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummaryCollection.rst new file mode 100644 index 0000000000..1ecb2efc2e --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegatedResourceAccessRequestSummaryCollection.rst @@ -0,0 +1,11 @@ +DelegatedResourceAccessRequestSummaryCollection +=============================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegatedResourceAccessRequestSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControl.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControl.rst new file mode 100644 index 0000000000..b7f9255964 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControl.rst @@ -0,0 +1,11 @@ +DelegationControl +================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationControl + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceCollection.rst new file mode 100644 index 0000000000..3e3f2504fa --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceCollection.rst @@ -0,0 +1,11 @@ +DelegationControlResourceCollection +=================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationControlResourceCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceSummary.rst new file mode 100644 index 0000000000..fa03be77ed --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlResourceSummary.rst @@ -0,0 +1,11 @@ +DelegationControlResourceSummary +================================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationControlResourceSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummary.rst new file mode 100644 index 0000000000..5f010b8577 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummary.rst @@ -0,0 +1,11 @@ +DelegationControlSummary +======================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationControlSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummaryCollection.rst new file mode 100644 index 0000000000..098939e196 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationControlSummaryCollection.rst @@ -0,0 +1,11 @@ +DelegationControlSummaryCollection +================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationControlSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscription.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscription.rst new file mode 100644 index 0000000000..1405267ba7 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscription.rst @@ -0,0 +1,11 @@ +DelegationSubscription +====================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationSubscription + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummary.rst new file mode 100644 index 0000000000..f856392630 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummary.rst @@ -0,0 +1,11 @@ +DelegationSubscriptionSummary +============================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationSubscriptionSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummaryCollection.rst new file mode 100644 index 0000000000..bcde32e409 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.DelegationSubscriptionSummaryCollection.rst @@ -0,0 +1,11 @@ +DelegationSubscriptionSummaryCollection +======================================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: DelegationSubscriptionSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails.rst new file mode 100644 index 0000000000..ab2314be58 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails.rst @@ -0,0 +1,11 @@ +RejectDelegatedResourceAccessRequestDetails +=========================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: RejectDelegatedResourceAccessRequestDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails.rst new file mode 100644 index 0000000000..e395a4eeb0 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails.rst @@ -0,0 +1,11 @@ +RevokeDelegatedResourceAccessRequestDetails +=========================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: RevokeDelegatedResourceAccessRequestDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProvider.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProvider.rst new file mode 100644 index 0000000000..69579819eb --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProvider.rst @@ -0,0 +1,11 @@ +ServiceProvider +=============== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProvider + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderAction.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderAction.rst new file mode 100644 index 0000000000..bdf6d34f04 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderAction.rst @@ -0,0 +1,11 @@ +ServiceProviderAction +===================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderAction + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionProperties.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionProperties.rst new file mode 100644 index 0000000000..6600d7e23f --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionProperties.rst @@ -0,0 +1,11 @@ +ServiceProviderActionProperties +=============================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderActionProperties + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummary.rst new file mode 100644 index 0000000000..29946bf6d3 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummary.rst @@ -0,0 +1,11 @@ +ServiceProviderActionSummary +============================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderActionSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummaryCollection.rst new file mode 100644 index 0000000000..22eccf361f --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderActionSummaryCollection.rst @@ -0,0 +1,11 @@ +ServiceProviderActionSummaryCollection +====================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderActionSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionCollection.rst new file mode 100644 index 0000000000..4e7fcf4276 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionCollection.rst @@ -0,0 +1,11 @@ +ServiceProviderInteractionCollection +==================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderInteractionCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionRequestDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionRequestDetails.rst new file mode 100644 index 0000000000..8490d4fa0d --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionRequestDetails.rst @@ -0,0 +1,11 @@ +ServiceProviderInteractionRequestDetails +======================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderInteractionRequestDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionSummary.rst new file mode 100644 index 0000000000..3006c7fd99 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderInteractionSummary.rst @@ -0,0 +1,11 @@ +ServiceProviderInteractionSummary +================================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderInteractionSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummary.rst new file mode 100644 index 0000000000..5fa4e3cf43 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummary.rst @@ -0,0 +1,11 @@ +ServiceProviderSummary +====================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummaryCollection.rst new file mode 100644 index 0000000000..23893ec73d --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.ServiceProviderSummaryCollection.rst @@ -0,0 +1,11 @@ +ServiceProviderSummaryCollection +================================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: ServiceProviderSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationControlDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationControlDetails.rst new file mode 100644 index 0000000000..6927687525 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationControlDetails.rst @@ -0,0 +1,11 @@ +UpdateDelegationControlDetails +============================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: UpdateDelegationControlDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails.rst new file mode 100644 index 0000000000..0e96925e72 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails.rst @@ -0,0 +1,11 @@ +UpdateDelegationSubscriptionDetails +=================================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: UpdateDelegationSubscriptionDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequest.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequest.rst new file mode 100644 index 0000000000..b904ab1d78 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequest.rst @@ -0,0 +1,11 @@ +WorkRequest +=========== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequest + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestError.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestError.rst new file mode 100644 index 0000000000..60d9f354cf --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestError.rst @@ -0,0 +1,11 @@ +WorkRequestError +================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestError + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestErrorCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestErrorCollection.rst new file mode 100644 index 0000000000..8f44c2980f --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestErrorCollection.rst @@ -0,0 +1,11 @@ +WorkRequestErrorCollection +========================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestErrorCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntry.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntry.rst new file mode 100644 index 0000000000..49da3ea735 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntry.rst @@ -0,0 +1,11 @@ +WorkRequestLogEntry +=================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestLogEntry + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntryCollection.rst new file mode 100644 index 0000000000..790d4bbcf4 --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestLogEntryCollection.rst @@ -0,0 +1,11 @@ +WorkRequestLogEntryCollection +============================= + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestLogEntryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestResource.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestResource.rst new file mode 100644 index 0000000000..db4a40a65a --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestResource.rst @@ -0,0 +1,11 @@ +WorkRequestResource +=================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestResource + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummary.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummary.rst new file mode 100644 index 0000000000..787f1c7daf --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummary.rst @@ -0,0 +1,11 @@ +WorkRequestSummary +================== + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummaryCollection.rst b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummaryCollection.rst new file mode 100644 index 0000000000..34ab50feca --- /dev/null +++ b/docs/api/delegate_access_control/models/oci.delegate_access_control.models.WorkRequestSummaryCollection.rst @@ -0,0 +1,11 @@ +WorkRequestSummaryCollection +============================ + +.. currentmodule:: oci.delegate_access_control.models + +.. autoclass:: WorkRequestSummaryCollection + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/file_storage.rst b/docs/api/file_storage.rst index 453b058a71..b0ff4f3558 100644 --- a/docs/api/file_storage.rst +++ b/docs/api/file_storage.rst @@ -58,6 +58,7 @@ File Storage oci.file_storage.models.ReplicationSummary oci.file_storage.models.ReplicationTarget oci.file_storage.models.ReplicationTargetSummary + oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails oci.file_storage.models.Snapshot oci.file_storage.models.SnapshotSchedule oci.file_storage.models.SnapshotSummary @@ -72,5 +73,6 @@ File Storage oci.file_storage.models.UpdateOutboundConnectorDetails oci.file_storage.models.UpdateReplicationDetails oci.file_storage.models.UpdateSnapshotDetails + oci.file_storage.models.UpgradeShapeMountTargetDetails oci.file_storage.models.ValidateKeyTabsDetails oci.file_storage.models.ValidateKeyTabsResponseDetails diff --git a/docs/api/file_storage/models/oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails.rst b/docs/api/file_storage/models/oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails.rst new file mode 100644 index 0000000000..bfb508550e --- /dev/null +++ b/docs/api/file_storage/models/oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails.rst @@ -0,0 +1,11 @@ +ScheduleDowngradeShapeMountTargetDetails +======================================== + +.. currentmodule:: oci.file_storage.models + +.. autoclass:: ScheduleDowngradeShapeMountTargetDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/file_storage/models/oci.file_storage.models.UpgradeShapeMountTargetDetails.rst b/docs/api/file_storage/models/oci.file_storage.models.UpgradeShapeMountTargetDetails.rst new file mode 100644 index 0000000000..945ef3d73e --- /dev/null +++ b/docs/api/file_storage/models/oci.file_storage.models.UpgradeShapeMountTargetDetails.rst @@ -0,0 +1,11 @@ +UpgradeShapeMountTargetDetails +============================== + +.. currentmodule:: oci.file_storage.models + +.. autoclass:: UpgradeShapeMountTargetDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/landing.rst b/docs/api/landing.rst index 09d1473991..84fc4c2c49 100644 --- a/docs/api/landing.rst +++ b/docs/api/landing.rst @@ -75,6 +75,7 @@ API Reference * :doc:`Db Backups ` * :doc:`Db Management ` * :doc:`Db System ` +* :doc:`Delegate Access Control ` * :doc:`Deployment ` * :doc:`Desktop Service ` * :doc:`Devops ` @@ -201,6 +202,7 @@ API Reference * :doc:`Sddc ` * :doc:`Secrets ` * :doc:`Sender Invitation ` +* :doc:`Service ` * :doc:`Service Catalog ` * :doc:`Service Connector ` * :doc:`Service Manager Proxy ` @@ -244,6 +246,7 @@ API Reference * :doc:`Work Request ` * :doc:`Work Request ` * :doc:`Work Request ` +* :doc:`Work Request ` * :doc:`Work Requests ` * :doc:`Work Requests ` * :doc:`Work Requests ` @@ -313,6 +316,7 @@ API Reference database_management database_migration database_tools + delegate_access_control demand_signal desktops devops diff --git a/docs/api/mysql.rst b/docs/api/mysql.rst index 6f38d7be5a..3b01113851 100644 --- a/docs/api/mysql.rst +++ b/docs/api/mysql.rst @@ -65,6 +65,7 @@ Mysql oci.mysql.models.CreateDeletionPolicyDetails oci.mysql.models.CreateMaintenanceDetails oci.mysql.models.CreateReplicaDetails + oci.mysql.models.CustomerContact oci.mysql.models.DataStorage oci.mysql.models.DataStorageDetails oci.mysql.models.DbSystem diff --git a/docs/api/mysql/models/oci.mysql.models.CustomerContact.rst b/docs/api/mysql/models/oci.mysql.models.CustomerContact.rst new file mode 100644 index 0000000000..36a1ab0d7c --- /dev/null +++ b/docs/api/mysql/models/oci.mysql.models.CustomerContact.rst @@ -0,0 +1,11 @@ +CustomerContact +=============== + +.. currentmodule:: oci.mysql.models + +.. autoclass:: CustomerContact + :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 7dedb0d1f0..90aa31cf04 100644 --- a/docs/api/object_storage.rst +++ b/docs/api/object_storage.rst @@ -18,6 +18,7 @@ Object Storage :nosignatures: :template: autosummary/model_class.rst + oci.object_storage.models.AccessTargetDetails oci.object_storage.models.Bucket oci.object_storage.models.BucketSummary oci.object_storage.models.CommitMultipartUploadDetails @@ -26,9 +27,11 @@ Object Storage oci.object_storage.models.CreateBucketDetails oci.object_storage.models.CreateMultipartUploadDetails oci.object_storage.models.CreatePreauthenticatedRequestDetails + oci.object_storage.models.CreatePrivateEndpointDetails oci.object_storage.models.CreateReplicationPolicyDetails oci.object_storage.models.CreateRetentionRuleDetails oci.object_storage.models.Duration + oci.object_storage.models.Fqdns oci.object_storage.models.ListObjects oci.object_storage.models.MultipartUpload oci.object_storage.models.MultipartUploadPartSummary @@ -42,6 +45,9 @@ Object Storage oci.object_storage.models.PatternDetails oci.object_storage.models.PreauthenticatedRequest oci.object_storage.models.PreauthenticatedRequestSummary + oci.object_storage.models.PrefixFqdns + oci.object_storage.models.PrivateEndpoint + oci.object_storage.models.PrivateEndpointSummary oci.object_storage.models.PutObjectLifecyclePolicyDetails oci.object_storage.models.ReencryptObjectDetails oci.object_storage.models.RenameObjectDetails @@ -57,6 +63,7 @@ Object Storage oci.object_storage.models.UpdateBucketDetails oci.object_storage.models.UpdateNamespaceMetadataDetails oci.object_storage.models.UpdateObjectStorageTierDetails + oci.object_storage.models.UpdatePrivateEndpointDetails 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.AccessTargetDetails.rst b/docs/api/object_storage/models/oci.object_storage.models.AccessTargetDetails.rst new file mode 100644 index 0000000000..7031a4cffc --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.AccessTargetDetails.rst @@ -0,0 +1,11 @@ +AccessTargetDetails +=================== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: AccessTargetDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.CreatePrivateEndpointDetails.rst b/docs/api/object_storage/models/oci.object_storage.models.CreatePrivateEndpointDetails.rst new file mode 100644 index 0000000000..0e6fbbd7a0 --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.CreatePrivateEndpointDetails.rst @@ -0,0 +1,11 @@ +CreatePrivateEndpointDetails +============================ + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: CreatePrivateEndpointDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.Fqdns.rst b/docs/api/object_storage/models/oci.object_storage.models.Fqdns.rst new file mode 100644 index 0000000000..1e89732b5f --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.Fqdns.rst @@ -0,0 +1,11 @@ +Fqdns +===== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: Fqdns + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.PrefixFqdns.rst b/docs/api/object_storage/models/oci.object_storage.models.PrefixFqdns.rst new file mode 100644 index 0000000000..94a06cbd46 --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.PrefixFqdns.rst @@ -0,0 +1,11 @@ +PrefixFqdns +=========== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: PrefixFqdns + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpoint.rst b/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpoint.rst new file mode 100644 index 0000000000..eb85e7c4eb --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpoint.rst @@ -0,0 +1,11 @@ +PrivateEndpoint +=============== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: PrivateEndpoint + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpointSummary.rst b/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpointSummary.rst new file mode 100644 index 0000000000..bef542082d --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.PrivateEndpointSummary.rst @@ -0,0 +1,11 @@ +PrivateEndpointSummary +====================== + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: PrivateEndpointSummary + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/object_storage/models/oci.object_storage.models.UpdatePrivateEndpointDetails.rst b/docs/api/object_storage/models/oci.object_storage.models.UpdatePrivateEndpointDetails.rst new file mode 100644 index 0000000000..8d88cc31af --- /dev/null +++ b/docs/api/object_storage/models/oci.object_storage.models.UpdatePrivateEndpointDetails.rst @@ -0,0 +1,11 @@ +UpdatePrivateEndpointDetails +============================ + +.. currentmodule:: oci.object_storage.models + +.. autoclass:: UpdatePrivateEndpointDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/recovery.rst b/docs/api/recovery.rst index ced0ac8382..72702e1f89 100644 --- a/docs/api/recovery.rst +++ b/docs/api/recovery.rst @@ -19,6 +19,7 @@ Recovery :template: autosummary/model_class.rst oci.recovery.models.ChangeProtectedDatabaseCompartmentDetails + oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails oci.recovery.models.ChangeProtectionPolicyCompartmentDetails oci.recovery.models.ChangeRecoveryServiceSubnetCompartmentDetails oci.recovery.models.CreateProtectedDatabaseDetails diff --git a/docs/api/recovery/models/oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails.rst b/docs/api/recovery/models/oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails.rst new file mode 100644 index 0000000000..9f02763836 --- /dev/null +++ b/docs/api/recovery/models/oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails.rst @@ -0,0 +1,11 @@ +ChangeProtectedDatabaseSubscriptionDetails +========================================== + +.. currentmodule:: oci.recovery.models + +.. autoclass:: ChangeProtectedDatabaseSubscriptionDetails + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/docs/api/waf.rst b/docs/api/waf.rst index 827e3289d6..e63a1efd68 100644 --- a/docs/api/waf.rst +++ b/docs/api/waf.rst @@ -34,6 +34,7 @@ Waf oci.waf.models.CreateWebAppFirewallDetails oci.waf.models.CreateWebAppFirewallLoadBalancerDetails oci.waf.models.CreateWebAppFirewallPolicyDetails + oci.waf.models.DynamicHttpResponseBody oci.waf.models.HttpResponseBody oci.waf.models.NetworkAddressList oci.waf.models.NetworkAddressListAddresses diff --git a/docs/api/waf/models/oci.waf.models.DynamicHttpResponseBody.rst b/docs/api/waf/models/oci.waf.models.DynamicHttpResponseBody.rst new file mode 100644 index 0000000000..f6d8aa4d23 --- /dev/null +++ b/docs/api/waf/models/oci.waf.models.DynamicHttpResponseBody.rst @@ -0,0 +1,11 @@ +DynamicHttpResponseBody +======================= + +.. currentmodule:: oci.waf.models + +.. autoclass:: DynamicHttpResponseBody + :show-inheritance: + :special-members: __init__ + :members: + :undoc-members: + :inherited-members: \ No newline at end of file diff --git a/src/oci/__init__.py b/src/oci/__init__.py index 3d1af3925c..f7a70759cc 100644 --- a/src/oci/__init__.py +++ b/src/oci/__init__.py @@ -19,7 +19,7 @@ else: __all__ = [ "BaseClient", "Error", "Request", "Response", "Signer", "config", "constants", "decorators", "exceptions", "regions", "wait_until", "pagination", "auth", "retry", "fips", "circuit_breaker", "alloy", - "access_governance_cp", "adm", "ai_anomaly_detection", "ai_document", "ai_language", "ai_speech", "ai_vision", "analytics", "announcements_service", "apigateway", "apm_config", "apm_control_plane", "apm_synthetics", "apm_traces", "appmgmt_control", "artifacts", "audit", "autoscaling", "bastion", "bds", "blockchain", "budget", "capacity_management", "certificates", "certificates_management", "cims", "cloud_bridge", "cloud_guard", "cloud_migrations", "cluster_placement_groups", "compute_cloud_at_customer", "compute_instance_agent", "container_engine", "container_instances", "core", "dashboard_service", "data_catalog", "data_flow", "data_integration", "data_labeling_service", "data_labeling_service_dataplane", "data_safe", "data_science", "database", "database_management", "database_migration", "database_tools", "demand_signal", "desktops", "devops", "disaster_recovery", "dns", "dts", "em_warehouse", "email", "email_data_plane", "events", "file_storage", "fleet_apps_management", "fleet_software_update", "functions", "fusion_apps", "generative_ai", "generative_ai_inference", "generic_artifacts_content", "globally_distributed_database", "golden_gate", "governance_rules_control_plane", "healthchecks", "identity", "identity_data_plane", "identity_domains", "integration", "jms", "jms_java_downloads", "key_management", "license_manager", "limits", "load_balancer", "lockbox", "log_analytics", "logging", "loggingingestion", "loggingsearch", "management_agent", "management_dashboard", "marketplace", "marketplace_private_offer", "marketplace_publisher", "media_services", "monitoring", "mysql", "network_firewall", "network_load_balancer", "nosql", "object_storage", "oce", "oci_control_center", "ocvp", "oda", "onesubscription", "ons", "opa", "opensearch", "operator_access_control", "opsi", "optimizer", "os_management", "os_management_hub", "osp_gateway", "osub_billing_schedule", "osub_organization_subscription", "osub_subscription", "osub_usage", "psql", "queue", "recovery", "redis", "resource_manager", "resource_scheduler", "resource_search", "rover", "sch", "secrets", "service_catalog", "service_manager_proxy", "service_mesh", "stack_monitoring", "streaming", "tenant_manager_control_plane", "threat_intelligence", "usage", "usage_api", "vault", "vbs_inst", "visual_builder", "vn_monitoring", "vulnerability_scanning", "waa", "waas", "waf", "work_requests" + "access_governance_cp", "adm", "ai_anomaly_detection", "ai_document", "ai_language", "ai_speech", "ai_vision", "analytics", "announcements_service", "apigateway", "apm_config", "apm_control_plane", "apm_synthetics", "apm_traces", "appmgmt_control", "artifacts", "audit", "autoscaling", "bastion", "bds", "blockchain", "budget", "capacity_management", "certificates", "certificates_management", "cims", "cloud_bridge", "cloud_guard", "cloud_migrations", "cluster_placement_groups", "compute_cloud_at_customer", "compute_instance_agent", "container_engine", "container_instances", "core", "dashboard_service", "data_catalog", "data_flow", "data_integration", "data_labeling_service", "data_labeling_service_dataplane", "data_safe", "data_science", "database", "database_management", "database_migration", "database_tools", "delegate_access_control", "demand_signal", "desktops", "devops", "disaster_recovery", "dns", "dts", "em_warehouse", "email", "email_data_plane", "events", "file_storage", "fleet_apps_management", "fleet_software_update", "functions", "fusion_apps", "generative_ai", "generative_ai_inference", "generic_artifacts_content", "globally_distributed_database", "golden_gate", "governance_rules_control_plane", "healthchecks", "identity", "identity_data_plane", "identity_domains", "integration", "jms", "jms_java_downloads", "key_management", "license_manager", "limits", "load_balancer", "lockbox", "log_analytics", "logging", "loggingingestion", "loggingsearch", "management_agent", "management_dashboard", "marketplace", "marketplace_private_offer", "marketplace_publisher", "media_services", "monitoring", "mysql", "network_firewall", "network_load_balancer", "nosql", "object_storage", "oce", "oci_control_center", "ocvp", "oda", "onesubscription", "ons", "opa", "opensearch", "operator_access_control", "opsi", "optimizer", "os_management", "os_management_hub", "osp_gateway", "osub_billing_schedule", "osub_organization_subscription", "osub_subscription", "osub_usage", "psql", "queue", "recovery", "redis", "resource_manager", "resource_scheduler", "resource_search", "rover", "sch", "secrets", "service_catalog", "service_manager_proxy", "service_mesh", "stack_monitoring", "streaming", "tenant_manager_control_plane", "threat_intelligence", "usage", "usage_api", "vault", "vbs_inst", "visual_builder", "vn_monitoring", "vulnerability_scanning", "waa", "waas", "waf", "work_requests" ] if sys.version_info >= (3, 7) and os.getenv("OCI_PYTHON_SDK_LAZY_IMPORTS_DISABLED", "False").lower() != "true": def __getattr__(x): @@ -30,4 +30,4 @@ def __getattr__(x): return importlib.import_module(__name__ + "." + x) raise AttributeError("module " + __name__ + " has no attribute" + x) else: - from . import access_governance_cp, adm, ai_anomaly_detection, ai_document, ai_language, ai_speech, ai_vision, analytics, announcements_service, apigateway, apm_config, apm_control_plane, apm_synthetics, apm_traces, appmgmt_control, artifacts, audit, autoscaling, bastion, bds, blockchain, budget, capacity_management, certificates, certificates_management, cims, cloud_bridge, cloud_guard, cloud_migrations, cluster_placement_groups, compute_cloud_at_customer, compute_instance_agent, container_engine, container_instances, core, dashboard_service, data_catalog, data_flow, data_integration, data_labeling_service, data_labeling_service_dataplane, data_safe, data_science, database, database_management, database_migration, database_tools, demand_signal, desktops, devops, disaster_recovery, dns, dts, em_warehouse, email, email_data_plane, events, file_storage, fleet_apps_management, fleet_software_update, functions, fusion_apps, generative_ai, generative_ai_inference, generic_artifacts_content, globally_distributed_database, golden_gate, governance_rules_control_plane, healthchecks, identity, identity_data_plane, identity_domains, integration, jms, jms_java_downloads, key_management, license_manager, limits, load_balancer, lockbox, log_analytics, logging, loggingingestion, loggingsearch, management_agent, management_dashboard, marketplace, marketplace_private_offer, marketplace_publisher, media_services, monitoring, mysql, network_firewall, network_load_balancer, nosql, object_storage, oce, oci_control_center, ocvp, oda, onesubscription, ons, opa, opensearch, operator_access_control, opsi, optimizer, os_management, os_management_hub, osp_gateway, osub_billing_schedule, osub_organization_subscription, osub_subscription, osub_usage, psql, queue, recovery, redis, resource_manager, resource_scheduler, resource_search, rover, sch, secrets, service_catalog, service_manager_proxy, service_mesh, stack_monitoring, streaming, tenant_manager_control_plane, threat_intelligence, usage, usage_api, vault, vbs_inst, visual_builder, vn_monitoring, vulnerability_scanning, waa, waas, waf, work_requests + from . import access_governance_cp, adm, ai_anomaly_detection, ai_document, ai_language, ai_speech, ai_vision, analytics, announcements_service, apigateway, apm_config, apm_control_plane, apm_synthetics, apm_traces, appmgmt_control, artifacts, audit, autoscaling, bastion, bds, blockchain, budget, capacity_management, certificates, certificates_management, cims, cloud_bridge, cloud_guard, cloud_migrations, cluster_placement_groups, compute_cloud_at_customer, compute_instance_agent, container_engine, container_instances, core, dashboard_service, data_catalog, data_flow, data_integration, data_labeling_service, data_labeling_service_dataplane, data_safe, data_science, database, database_management, database_migration, database_tools, delegate_access_control, demand_signal, desktops, devops, disaster_recovery, dns, dts, em_warehouse, email, email_data_plane, events, file_storage, fleet_apps_management, fleet_software_update, functions, fusion_apps, generative_ai, generative_ai_inference, generic_artifacts_content, globally_distributed_database, golden_gate, governance_rules_control_plane, healthchecks, identity, identity_data_plane, identity_domains, integration, jms, jms_java_downloads, key_management, license_manager, limits, load_balancer, lockbox, log_analytics, logging, loggingingestion, loggingsearch, management_agent, management_dashboard, marketplace, marketplace_private_offer, marketplace_publisher, media_services, monitoring, mysql, network_firewall, network_load_balancer, nosql, object_storage, oce, oci_control_center, ocvp, oda, onesubscription, ons, opa, opensearch, operator_access_control, opsi, optimizer, os_management, os_management_hub, osp_gateway, osub_billing_schedule, osub_organization_subscription, osub_subscription, osub_usage, psql, queue, recovery, redis, resource_manager, resource_scheduler, resource_search, rover, sch, secrets, service_catalog, service_manager_proxy, service_mesh, stack_monitoring, streaming, tenant_manager_control_plane, threat_intelligence, usage, usage_api, vault, vbs_inst, visual_builder, vn_monitoring, vulnerability_scanning, waa, waas, waf, work_requests diff --git a/src/oci/ai_document/ai_service_document_client.py b/src/oci/ai_document/ai_service_document_client.py index 8d6924f36c..19a4208a74 100644 --- a/src/oci/ai_document/ai_service_document_client.py +++ b/src/oci/ai_document/ai_service_document_client.py @@ -116,6 +116,272 @@ def __init__(self, config, **kwargs): self.retry_strategy = kwargs.get('retry_strategy') self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback') + def add_model_lock(self, model_id, add_model_lock_details, **kwargs): + """ + Adds a lock to a resource. + + + :param str model_id: (required) + A unique model identifier. + + :param oci.ai_document.models.AddModelLockDetails add_model_lock_details: (required) + Request payload to add lock to the 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 the 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 + might be rejected. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 is_lock_override: (optional) + Whether to override locks (if any exist). + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.ai_document.models.Model` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use add_model_lock API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['modelId'] + resource_path = "/models/{modelId}/actions/addLock" + method = "POST" + operation_name = "add_model_lock" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/document-understanding/20221109/Model/AddModelLock" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_retry_token", + "opc_request_id", + "if_match", + "is_lock_override" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"add_model_lock got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "modelId": model_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + body=add_model_lock_details, + response_type="Model", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + body=add_model_lock_details, + response_type="Model", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def add_project_lock(self, project_id, add_project_lock_details, **kwargs): + """ + Adds a lock to a resource. + + + :param str project_id: (required) + A unique project identifier. + + :param oci.ai_document.models.AddProjectLockDetails add_project_lock_details: (required) + Request payload to add lock to the 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 the 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 + might be rejected. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 is_lock_override: (optional) + Whether to override locks (if any exist). + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.ai_document.models.Project` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use add_project_lock API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['projectId'] + resource_path = "/projects/{projectId}/actions/addLock" + method = "POST" + operation_name = "add_project_lock" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/document-understanding/20221109/Project/AddProjectLock" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_retry_token", + "opc_request_id", + "if_match", + "is_lock_override" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"add_project_lock got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "projectId": project_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + body=add_project_lock_details, + response_type="Project", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + body=add_project_lock_details, + response_type="Project", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def analyze_document(self, analyze_document_details, **kwargs): """ Perform different types of document analysis. @@ -440,6 +706,9 @@ def change_model_compartment(self, model_id, change_model_compartment_details, * :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -470,7 +739,8 @@ def change_model_compartment(self, model_id, change_model_compartment_details, * "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -487,6 +757,11 @@ def change_model_compartment(self, model_id, change_model_compartment_details, * if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -509,6 +784,7 @@ def change_model_compartment(self, model_id, change_model_compartment_details, * resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=change_model_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -520,6 +796,7 @@ def change_model_compartment(self, model_id, change_model_compartment_details, * resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=change_model_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -548,6 +825,9 @@ def change_project_compartment(self, project_id, change_project_compartment_deta :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -578,7 +858,8 @@ def change_project_compartment(self, project_id, change_project_compartment_deta "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -595,6 +876,11 @@ def change_project_compartment(self, project_id, change_project_compartment_deta if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -617,6 +903,7 @@ def change_project_compartment(self, project_id, change_project_compartment_deta resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=change_project_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -628,6 +915,7 @@ def change_project_compartment(self, project_id, change_project_compartment_deta resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=change_project_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -947,6 +1235,9 @@ def delete_model(self, model_id, **kwargs): :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -977,7 +1268,8 @@ def delete_model(self, model_id, **kwargs): "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -994,6 +1286,11 @@ def delete_model(self, model_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -1016,6 +1313,7 @@ def delete_model(self, model_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -1026,6 +1324,7 @@ def delete_model(self, model_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -1050,6 +1349,9 @@ def delete_project(self, project_id, **kwargs): :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -1080,7 +1382,8 @@ def delete_project(self, project_id, **kwargs): "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -1097,6 +1400,11 @@ def delete_project(self, project_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -1119,6 +1427,7 @@ def delete_project(self, project_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -1129,6 +1438,7 @@ def delete_project(self, project_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -2394,6 +2704,272 @@ def patch_model(self, model_id, patch_model_details, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) + def remove_model_lock(self, model_id, remove_model_lock_details, **kwargs): + """ + Remove a lock from a resource. + + + :param str model_id: (required) + A unique model identifier. + + :param oci.ai_document.models.RemoveModelLockDetails remove_model_lock_details: (required) + Request payload to remove lock to the 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 the 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 + might be rejected. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 is_lock_override: (optional) + Whether to override locks (if any exist). + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.ai_document.models.Model` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use remove_model_lock API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['modelId'] + resource_path = "/models/{modelId}/actions/removeLock" + method = "POST" + operation_name = "remove_model_lock" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/document-understanding/20221109/Model/RemoveModelLock" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_retry_token", + "opc_request_id", + "if_match", + "is_lock_override" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"remove_model_lock got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "modelId": model_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + body=remove_model_lock_details, + response_type="Model", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + body=remove_model_lock_details, + response_type="Model", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def remove_project_lock(self, project_id, remove_project_lock_details, **kwargs): + """ + Remove a lock from a resource. + + + :param str project_id: (required) + A unique project identifier. + + :param oci.ai_document.models.RemoveProjectLockDetails remove_project_lock_details: (required) + Request payload to remove lock to the 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 the 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 + might be rejected. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 is_lock_override: (optional) + Whether to override locks (if any exist). + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.ai_document.models.Project` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use remove_project_lock API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['projectId'] + resource_path = "/projects/{projectId}/actions/removeLock" + method = "POST" + operation_name = "remove_project_lock" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/document-understanding/20221109/Project/RemoveProjectLock" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_retry_token", + "opc_request_id", + "if_match", + "is_lock_override" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"remove_project_lock got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "projectId": project_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + body=remove_project_lock_details, + response_type="Project", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + body=remove_project_lock_details, + response_type="Project", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def update_model(self, model_id, update_model_details, **kwargs): """ Updates the model metadata. @@ -2415,6 +2991,9 @@ def update_model(self, model_id, update_model_details, **kwargs): :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -2445,7 +3024,8 @@ def update_model(self, model_id, update_model_details, **kwargs): "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -2462,6 +3042,11 @@ def update_model(self, model_id, update_model_details, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -2484,6 +3069,7 @@ def update_model(self, model_id, update_model_details, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=update_model_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -2495,6 +3081,7 @@ def update_model(self, model_id, update_model_details, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=update_model_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -2523,6 +3110,9 @@ def update_project(self, project_id, update_project_details, **kwargs): :param str opc_request_id: (optional) The client request ID for tracing. + :param bool is_lock_override: (optional) + Whether to override locks (if any exist). + :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. @@ -2553,7 +3143,8 @@ def update_project(self, project_id, update_project_details, **kwargs): "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "opc_request_id", + "is_lock_override" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -2570,6 +3161,11 @@ def update_project(self, project_id, update_project_details, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "isLockOverride": kwargs.get("is_lock_override", 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", @@ -2592,6 +3188,7 @@ def update_project(self, project_id, update_project_details, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=update_project_details, allow_control_chars=kwargs.get('allow_control_chars'), @@ -2603,6 +3200,7 @@ def update_project(self, project_id, update_project_details, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, body=update_project_details, allow_control_chars=kwargs.get('allow_control_chars'), diff --git a/src/oci/ai_document/ai_service_document_client_composite_operations.py b/src/oci/ai_document/ai_service_document_client_composite_operations.py index b382c5a1ed..fe55e2d934 100644 --- a/src/oci/ai_document/ai_service_document_client_composite_operations.py +++ b/src/oci/ai_document/ai_service_document_client_composite_operations.py @@ -25,6 +25,96 @@ def __init__(self, client, **kwargs): """ self.client = client + def add_model_lock_and_wait_for_state(self, model_id, add_model_lock_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.add_model_lock` and waits for the :py:class:`~oci.ai_document.models.Model` acted upon + to enter the given state(s). + + :param str model_id: (required) + A unique model identifier. + + :param oci.ai_document.models.AddModelLockDetails add_model_lock_details: (required) + Request payload to add lock to the resource. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.ai_document.models.Model.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.ai_document.AIServiceDocumentClient.add_model_lock` + + :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.add_model_lock(model_id, add_model_lock_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + model_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_model(model_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def add_project_lock_and_wait_for_state(self, project_id, add_project_lock_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.add_project_lock` and waits for the :py:class:`~oci.ai_document.models.Project` acted upon + to enter the given state(s). + + :param str project_id: (required) + A unique project identifier. + + :param oci.ai_document.models.AddProjectLockDetails add_project_lock_details: (required) + Request payload to add lock to the resource. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.ai_document.models.Project.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.ai_document.AIServiceDocumentClient.add_project_lock` + + :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.add_project_lock(project_id, add_project_lock_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + project_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_project(project_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def create_model_and_wait_for_state(self, create_model_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.create_model` and waits for the :py:class:`~oci.ai_document.models.WorkRequest` @@ -281,6 +371,96 @@ def patch_model_and_wait_for_state(self, model_id, patch_model_details, wait_for except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def remove_model_lock_and_wait_for_state(self, model_id, remove_model_lock_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.remove_model_lock` and waits for the :py:class:`~oci.ai_document.models.Model` acted upon + to enter the given state(s). + + :param str model_id: (required) + A unique model identifier. + + :param oci.ai_document.models.RemoveModelLockDetails remove_model_lock_details: (required) + Request payload to remove lock to the resource. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.ai_document.models.Model.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.ai_document.AIServiceDocumentClient.remove_model_lock` + + :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.remove_model_lock(model_id, remove_model_lock_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + model_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_model(model_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def remove_project_lock_and_wait_for_state(self, project_id, remove_project_lock_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.remove_project_lock` and waits for the :py:class:`~oci.ai_document.models.Project` acted upon + to enter the given state(s). + + :param str project_id: (required) + A unique project identifier. + + :param oci.ai_document.models.RemoveProjectLockDetails remove_project_lock_details: (required) + Request payload to remove lock to the resource. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.ai_document.models.Project.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.ai_document.AIServiceDocumentClient.remove_project_lock` + + :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.remove_project_lock(project_id, remove_project_lock_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + project_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_project(project_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def update_model_and_wait_for_state(self, model_id, update_model_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.ai_document.AIServiceDocumentClient.update_model` and waits for the :py:class:`~oci.ai_document.models.WorkRequest` diff --git a/src/oci/ai_document/models/__init__.py b/src/oci/ai_document/models/__init__.py index f3c96f0e5e..96863b4fc7 100644 --- a/src/oci/ai_document/models/__init__.py +++ b/src/oci/ai_document/models/__init__.py @@ -6,6 +6,8 @@ from __future__ import absolute_import +from .add_model_lock_details import AddModelLockDetails +from .add_project_lock_details import AddProjectLockDetails from .analyze_document_details import AnalyzeDocumentDetails from .analyze_document_result import AnalyzeDocumentResult from .bounding_polygon import BoundingPolygon @@ -67,6 +69,9 @@ from .project import Project from .project_collection import ProjectCollection from .project_summary import ProjectSummary +from .remove_model_lock_details import RemoveModelLockDetails +from .remove_project_lock_details import RemoveProjectLockDetails +from .resource_lock import ResourceLock from .table import Table from .table_row import TableRow from .update_model_details import UpdateModelDetails @@ -90,6 +95,8 @@ # Maps type names to classes for ai_document services. ai_document_type_mapping = { + "AddModelLockDetails": AddModelLockDetails, + "AddProjectLockDetails": AddProjectLockDetails, "AnalyzeDocumentDetails": AnalyzeDocumentDetails, "AnalyzeDocumentResult": AnalyzeDocumentResult, "BoundingPolygon": BoundingPolygon, @@ -151,6 +158,9 @@ "Project": Project, "ProjectCollection": ProjectCollection, "ProjectSummary": ProjectSummary, + "RemoveModelLockDetails": RemoveModelLockDetails, + "RemoveProjectLockDetails": RemoveProjectLockDetails, + "ResourceLock": ResourceLock, "Table": Table, "TableRow": TableRow, "UpdateModelDetails": UpdateModelDetails, diff --git a/src/oci/ai_document/models/add_model_lock_details.py b/src/oci/ai_document/models/add_model_lock_details.py new file mode 100644 index 0000000000..2dc24e76ae --- /dev/null +++ b/src/oci/ai_document/models/add_model_lock_details.py @@ -0,0 +1,150 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20221109 + + +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 AddModelLockDetails(object): + """ + Request payload to add lock to the resource. + """ + + #: A constant which can be used with the type property of a AddModelLockDetails. + #: This constant has a value of "FULL" + TYPE_FULL = "FULL" + + #: A constant which can be used with the type property of a AddModelLockDetails. + #: This constant has a value of "DELETE" + TYPE_DELETE = "DELETE" + + def __init__(self, **kwargs): + """ + Initializes a new AddModelLockDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this AddModelLockDetails. + Allowed values for this property are: "FULL", "DELETE" + :type type: str + + :param related_resource_id: + The value to assign to the related_resource_id property of this AddModelLockDetails. + :type related_resource_id: str + + :param message: + The value to assign to the message property of this AddModelLockDetails. + :type message: str + + """ + self.swagger_types = { + 'type': 'str', + 'related_resource_id': 'str', + 'message': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'related_resource_id': 'relatedResourceId', + 'message': 'message' + } + + self._type = None + self._related_resource_id = None + self._message = None + + @property + def type(self): + """ + **[Required]** Gets the type of this AddModelLockDetails. + Type of the lock. + + Allowed values for this property are: "FULL", "DELETE" + + + :return: The type of this AddModelLockDetails. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this AddModelLockDetails. + Type of the lock. + + + :param type: The type of this AddModelLockDetails. + :type: str + """ + allowed_values = ["FULL", "DELETE"] + if not value_allowed_none_or_none_sentinel(type, allowed_values): + raise ValueError( + f"Invalid value for `type`, must be None or one of {allowed_values}" + ) + self._type = type + + @property + def related_resource_id(self): + """ + Gets the related_resource_id of this AddModelLockDetails. + The ID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock. + + + :return: The related_resource_id of this AddModelLockDetails. + :rtype: str + """ + return self._related_resource_id + + @related_resource_id.setter + def related_resource_id(self, related_resource_id): + """ + Sets the related_resource_id of this AddModelLockDetails. + The ID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock. + + + :param related_resource_id: The related_resource_id of this AddModelLockDetails. + :type: str + """ + self._related_resource_id = related_resource_id + + @property + def message(self): + """ + Gets the message of this AddModelLockDetails. + A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked. + + + :return: The message of this AddModelLockDetails. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this AddModelLockDetails. + A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked. + + + :param message: The message of this AddModelLockDetails. + :type: str + """ + self._message = message + + 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/ai_document/models/add_project_lock_details.py b/src/oci/ai_document/models/add_project_lock_details.py new file mode 100644 index 0000000000..2b755a2116 --- /dev/null +++ b/src/oci/ai_document/models/add_project_lock_details.py @@ -0,0 +1,150 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20221109 + + +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 AddProjectLockDetails(object): + """ + Request payload to add lock to the resource. + """ + + #: A constant which can be used with the type property of a AddProjectLockDetails. + #: This constant has a value of "FULL" + TYPE_FULL = "FULL" + + #: A constant which can be used with the type property of a AddProjectLockDetails. + #: This constant has a value of "DELETE" + TYPE_DELETE = "DELETE" + + def __init__(self, **kwargs): + """ + Initializes a new AddProjectLockDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this AddProjectLockDetails. + Allowed values for this property are: "FULL", "DELETE" + :type type: str + + :param related_resource_id: + The value to assign to the related_resource_id property of this AddProjectLockDetails. + :type related_resource_id: str + + :param message: + The value to assign to the message property of this AddProjectLockDetails. + :type message: str + + """ + self.swagger_types = { + 'type': 'str', + 'related_resource_id': 'str', + 'message': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'related_resource_id': 'relatedResourceId', + 'message': 'message' + } + + self._type = None + self._related_resource_id = None + self._message = None + + @property + def type(self): + """ + **[Required]** Gets the type of this AddProjectLockDetails. + Type of the lock. + + Allowed values for this property are: "FULL", "DELETE" + + + :return: The type of this AddProjectLockDetails. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this AddProjectLockDetails. + Type of the lock. + + + :param type: The type of this AddProjectLockDetails. + :type: str + """ + allowed_values = ["FULL", "DELETE"] + if not value_allowed_none_or_none_sentinel(type, allowed_values): + raise ValueError( + f"Invalid value for `type`, must be None or one of {allowed_values}" + ) + self._type = type + + @property + def related_resource_id(self): + """ + Gets the related_resource_id of this AddProjectLockDetails. + The ID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock. + + + :return: The related_resource_id of this AddProjectLockDetails. + :rtype: str + """ + return self._related_resource_id + + @related_resource_id.setter + def related_resource_id(self, related_resource_id): + """ + Sets the related_resource_id of this AddProjectLockDetails. + The ID of the resource that is locking this resource. Indicates that deleting this resource will remove the lock. + + + :param related_resource_id: The related_resource_id of this AddProjectLockDetails. + :type: str + """ + self._related_resource_id = related_resource_id + + @property + def message(self): + """ + Gets the message of this AddProjectLockDetails. + A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked. + + + :return: The message of this AddProjectLockDetails. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this AddProjectLockDetails. + A message added by the creator of the lock. This is typically used to give an indication of why the resource is locked. + + + :param message: The message of this AddProjectLockDetails. + :type: str + """ + self._message = message + + 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/ai_document/models/analyze_document_details.py b/src/oci/ai_document/models/analyze_document_details.py index e3c1bab8ab..543723f4c9 100644 --- a/src/oci/ai_document/models/analyze_document_details.py +++ b/src/oci/ai_document/models/analyze_document_details.py @@ -56,8 +56,8 @@ class AnalyzeDocumentDetails(object): DOCUMENT_TYPE_OTHERS = "OTHERS" #: A constant which can be used with the document_type property of a AnalyzeDocumentDetails. - #: This constant has a value of "INSURANCE_CLAIM" - DOCUMENT_TYPE_INSURANCE_CLAIM = "INSURANCE_CLAIM" + #: This constant has a value of "HEALTH_INSURANCE_ID" + DOCUMENT_TYPE_HEALTH_INSURANCE_ID = "HEALTH_INSURANCE_ID" def __init__(self, **kwargs): """ @@ -86,7 +86,7 @@ def __init__(self, **kwargs): :param document_type: The value to assign to the document_type property of this AnalyzeDocumentDetails. - Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM" + Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID" :type document_type: str :param ocr_data: @@ -240,7 +240,7 @@ def document_type(self): Gets the document_type of this AnalyzeDocumentDetails. The document type. - Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM" + Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID" :return: The document_type of this AnalyzeDocumentDetails. @@ -258,7 +258,7 @@ def document_type(self, document_type): :param document_type: The document_type of this AnalyzeDocumentDetails. :type: str """ - allowed_values = ["INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM"] + allowed_values = ["INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID"] if not value_allowed_none_or_none_sentinel(document_type, allowed_values): raise ValueError( f"Invalid value for `document_type`, must be None or one of {allowed_values}" diff --git a/src/oci/ai_document/models/detected_document_type.py b/src/oci/ai_document/models/detected_document_type.py index a9108ba0d7..f345388279 100644 --- a/src/oci/ai_document/models/detected_document_type.py +++ b/src/oci/ai_document/models/detected_document_type.py @@ -24,10 +24,6 @@ def __init__(self, **kwargs): The value to assign to the document_type property of this DetectedDocumentType. :type document_type: str - :param document_id: - The value to assign to the document_id property of this DetectedDocumentType. - :type document_id: str - :param confidence: The value to assign to the confidence property of this DetectedDocumentType. :type confidence: float @@ -35,18 +31,15 @@ def __init__(self, **kwargs): """ self.swagger_types = { 'document_type': 'str', - 'document_id': 'str', 'confidence': 'float' } self.attribute_map = { 'document_type': 'documentType', - 'document_id': 'documentId', 'confidence': 'confidence' } self._document_type = None - self._document_id = None self._confidence = None @property @@ -73,34 +66,6 @@ def document_type(self, document_type): """ self._document_type = document_type - @property - def document_id(self): - """ - Gets the document_id of this DetectedDocumentType. - The `OCID`__ of the Key-Value Extraction model that was used to extract the key-value pairs. - - __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm - - - :return: The document_id of this DetectedDocumentType. - :rtype: str - """ - return self._document_id - - @document_id.setter - def document_id(self, document_id): - """ - Sets the document_id of this DetectedDocumentType. - The `OCID`__ of the Key-Value Extraction model that was used to extract the key-value pairs. - - __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm - - - :param document_id: The document_id of this DetectedDocumentType. - :type: str - """ - self._document_id = document_id - @property def confidence(self): """ diff --git a/src/oci/ai_document/models/document_classification_feature.py b/src/oci/ai_document/models/document_classification_feature.py index 38f2b97d73..0556fdf9f5 100644 --- a/src/oci/ai_document/models/document_classification_feature.py +++ b/src/oci/ai_document/models/document_classification_feature.py @@ -34,29 +34,22 @@ def __init__(self, **kwargs): The value to assign to the model_id property of this DocumentClassificationFeature. :type model_id: str - :param tenancy_id: - The value to assign to the tenancy_id property of this DocumentClassificationFeature. - :type tenancy_id: str - """ self.swagger_types = { 'feature_type': 'str', 'max_results': 'int', - 'model_id': 'str', - 'tenancy_id': 'str' + 'model_id': 'str' } self.attribute_map = { 'feature_type': 'featureType', 'max_results': 'maxResults', - 'model_id': 'modelId', - 'tenancy_id': 'tenancyId' + 'model_id': 'modelId' } self._feature_type = None self._max_results = None self._model_id = None - self._tenancy_id = None self._feature_type = 'DOCUMENT_CLASSIFICATION' @property @@ -107,30 +100,6 @@ def model_id(self, model_id): """ self._model_id = model_id - @property - def tenancy_id(self): - """ - Gets the tenancy_id of this DocumentClassificationFeature. - The custom model tenancy ID when modelId represents aliasName. - - - :return: The tenancy_id of this DocumentClassificationFeature. - :rtype: str - """ - return self._tenancy_id - - @tenancy_id.setter - def tenancy_id(self, tenancy_id): - """ - Sets the tenancy_id of this DocumentClassificationFeature. - The custom model tenancy ID when modelId represents aliasName. - - - :param tenancy_id: The tenancy_id of this DocumentClassificationFeature. - :type: str - """ - self._tenancy_id = tenancy_id - def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ai_document/models/document_key_value_extraction_feature.py b/src/oci/ai_document/models/document_key_value_extraction_feature.py index b90280d150..a2b569a050 100644 --- a/src/oci/ai_document/models/document_key_value_extraction_feature.py +++ b/src/oci/ai_document/models/document_key_value_extraction_feature.py @@ -30,26 +30,19 @@ def __init__(self, **kwargs): The value to assign to the model_id property of this DocumentKeyValueExtractionFeature. :type model_id: str - :param tenancy_id: - The value to assign to the tenancy_id property of this DocumentKeyValueExtractionFeature. - :type tenancy_id: str - """ self.swagger_types = { 'feature_type': 'str', - 'model_id': 'str', - 'tenancy_id': 'str' + 'model_id': 'str' } self.attribute_map = { 'feature_type': 'featureType', - 'model_id': 'modelId', - 'tenancy_id': 'tenancyId' + 'model_id': 'modelId' } self._feature_type = None self._model_id = None - self._tenancy_id = None self._feature_type = 'KEY_VALUE_EXTRACTION' @property @@ -76,30 +69,6 @@ def model_id(self, model_id): """ self._model_id = model_id - @property - def tenancy_id(self): - """ - Gets the tenancy_id of this DocumentKeyValueExtractionFeature. - The custom model tenancy ID when modelId represents aliasName. - - - :return: The tenancy_id of this DocumentKeyValueExtractionFeature. - :rtype: str - """ - return self._tenancy_id - - @tenancy_id.setter - def tenancy_id(self, tenancy_id): - """ - Sets the tenancy_id of this DocumentKeyValueExtractionFeature. - The custom model tenancy ID when modelId represents aliasName. - - - :param tenancy_id: The tenancy_id of this DocumentKeyValueExtractionFeature. - :type: str - """ - self._tenancy_id = tenancy_id - def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ai_document/models/general_processor_config.py b/src/oci/ai_document/models/general_processor_config.py index c93d4bba70..0e9211a59b 100644 --- a/src/oci/ai_document/models/general_processor_config.py +++ b/src/oci/ai_document/models/general_processor_config.py @@ -56,8 +56,8 @@ class GeneralProcessorConfig(ProcessorConfig): DOCUMENT_TYPE_OTHERS = "OTHERS" #: A constant which can be used with the document_type property of a GeneralProcessorConfig. - #: This constant has a value of "INSURANCE_CLAIM" - DOCUMENT_TYPE_INSURANCE_CLAIM = "INSURANCE_CLAIM" + #: This constant has a value of "HEALTH_INSURANCE_ID" + DOCUMENT_TYPE_HEALTH_INSURANCE_ID = "HEALTH_INSURANCE_ID" def __init__(self, **kwargs): """ @@ -73,7 +73,7 @@ def __init__(self, **kwargs): :param document_type: The value to assign to the document_type property of this GeneralProcessorConfig. - Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type document_type: str @@ -119,7 +119,7 @@ def document_type(self): Gets the document_type of this GeneralProcessorConfig. The document type. - Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -138,7 +138,7 @@ def document_type(self, document_type): :param document_type: The document_type of this GeneralProcessorConfig. :type: str """ - allowed_values = ["INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "INSURANCE_CLAIM"] + allowed_values = ["INVOICE", "RECEIPT", "RESUME", "TAX_FORM", "DRIVER_LICENSE", "PASSPORT", "BANK_STATEMENT", "CHECK", "PAYSLIP", "OTHERS", "HEALTH_INSURANCE_ID"] if not value_allowed_none_or_none_sentinel(document_type, allowed_values): document_type = 'UNKNOWN_ENUM_VALUE' self._document_type = document_type diff --git a/src/oci/ai_document/models/model.py b/src/oci/ai_document/models/model.py index 8e3e51e82c..e25b54638c 100644 --- a/src/oci/ai_document/models/model.py +++ b/src/oci/ai_document/models/model.py @@ -160,6 +160,10 @@ def __init__(self, **kwargs): The value to assign to the system_tags property of this Model. :type system_tags: dict(str, dict(str, object)) + :param locks: + The value to assign to the locks property of this Model. + :type locks: list[oci.ai_document.models.ResourceLock] + """ self.swagger_types = { 'id': 'str', @@ -187,7 +191,8 @@ def __init__(self, **kwargs): 'metrics': 'ModelMetrics', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))', - 'system_tags': 'dict(str, dict(str, object))' + 'system_tags': 'dict(str, dict(str, object))', + 'locks': 'list[ResourceLock]' } self.attribute_map = { @@ -216,7 +221,8 @@ def __init__(self, **kwargs): 'metrics': 'metrics', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags', - 'system_tags': 'systemTags' + 'system_tags': 'systemTags', + 'locks': 'locks' } self._id = None @@ -245,6 +251,7 @@ def __init__(self, **kwargs): self._freeform_tags = None self._defined_tags = None self._system_tags = None + self._locks = None @property def id(self): @@ -880,6 +887,30 @@ def system_tags(self, system_tags): """ self._system_tags = system_tags + @property + def locks(self): + """ + Gets the locks of this Model. + Locks associated with this resource. + + + :return: The locks of this Model. + :rtype: list[oci.ai_document.models.ResourceLock] + """ + return self._locks + + @locks.setter + def locks(self, locks): + """ + Sets the locks of this Model. + Locks associated with this resource. + + + :param locks: The locks of this Model. + :type: list[oci.ai_document.models.ResourceLock] + """ + self._locks = locks + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ai_document/models/model_summary.py b/src/oci/ai_document/models/model_summary.py index 81deadefa1..3d6c110dba 100644 --- a/src/oci/ai_document/models/model_summary.py +++ b/src/oci/ai_document/models/model_summary.py @@ -108,6 +108,10 @@ def __init__(self, **kwargs): The value to assign to the system_tags property of this ModelSummary. :type system_tags: dict(str, dict(str, object)) + :param locks: + The value to assign to the locks property of this ModelSummary. + :type locks: list[oci.ai_document.models.ResourceLock] + """ self.swagger_types = { 'id': 'str', @@ -131,7 +135,8 @@ def __init__(self, **kwargs): 'is_composed_model': 'bool', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))', - 'system_tags': 'dict(str, dict(str, object))' + 'system_tags': 'dict(str, dict(str, object))', + 'locks': 'list[ResourceLock]' } self.attribute_map = { @@ -156,7 +161,8 @@ def __init__(self, **kwargs): 'is_composed_model': 'isComposedModel', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags', - 'system_tags': 'systemTags' + 'system_tags': 'systemTags', + 'locks': 'locks' } self._id = None @@ -181,6 +187,7 @@ def __init__(self, **kwargs): self._freeform_tags = None self._defined_tags = None self._system_tags = None + self._locks = None @property def id(self): @@ -712,6 +719,30 @@ def system_tags(self, system_tags): """ self._system_tags = system_tags + @property + def locks(self): + """ + Gets the locks of this ModelSummary. + Locks associated with this resource. + + + :return: The locks of this ModelSummary. + :rtype: list[oci.ai_document.models.ResourceLock] + """ + return self._locks + + @locks.setter + def locks(self, locks): + """ + Sets the locks of this ModelSummary. + Locks associated with this resource. + + + :param locks: The locks of this ModelSummary. + :type: list[oci.ai_document.models.ResourceLock] + """ + self._locks = locks + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ai_document/models/output_location.py b/src/oci/ai_document/models/output_location.py index 5e77d0adf3..ed29608bf1 100644 --- a/src/oci/ai_document/models/output_location.py +++ b/src/oci/ai_document/models/output_location.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class OutputLocation(object): """ - The object storage location where to store analysis results. + The Object Storage Location. """ def __init__(self, **kwargs): diff --git a/src/oci/ai_document/models/project.py b/src/oci/ai_document/models/project.py index c2497c2c9d..f19053dcf6 100644 --- a/src/oci/ai_document/models/project.py +++ b/src/oci/ai_document/models/project.py @@ -90,6 +90,10 @@ def __init__(self, **kwargs): The value to assign to the system_tags property of this Project. :type system_tags: dict(str, dict(str, object)) + :param locks: + The value to assign to the locks property of this Project. + :type locks: list[oci.ai_document.models.ResourceLock] + """ self.swagger_types = { 'id': 'str', @@ -102,7 +106,8 @@ def __init__(self, **kwargs): 'lifecycle_details': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))', - 'system_tags': 'dict(str, dict(str, object))' + 'system_tags': 'dict(str, dict(str, object))', + 'locks': 'list[ResourceLock]' } self.attribute_map = { @@ -116,7 +121,8 @@ def __init__(self, **kwargs): 'lifecycle_details': 'lifecycleDetails', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags', - 'system_tags': 'systemTags' + 'system_tags': 'systemTags', + 'locks': 'locks' } self._id = None @@ -130,6 +136,7 @@ def __init__(self, **kwargs): self._freeform_tags = None self._defined_tags = None self._system_tags = None + self._locks = None @property def id(self): @@ -407,6 +414,30 @@ def system_tags(self, system_tags): """ self._system_tags = system_tags + @property + def locks(self): + """ + Gets the locks of this Project. + Locks associated with this resource. + + + :return: The locks of this Project. + :rtype: list[oci.ai_document.models.ResourceLock] + """ + return self._locks + + @locks.setter + def locks(self, locks): + """ + Sets the locks of this Project. + Locks associated with this resource. + + + :param locks: The locks of this Project. + :type: list[oci.ai_document.models.ResourceLock] + """ + self._locks = locks + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ai_document/models/remove_model_lock_details.py b/src/oci/ai_document/models/remove_model_lock_details.py new file mode 100644 index 0000000000..dfca81a8b0 --- /dev/null +++ b/src/oci/ai_document/models/remove_model_lock_details.py @@ -0,0 +1,88 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20221109 + + +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 RemoveModelLockDetails(object): + """ + Request payload to remove lock to the resource. + """ + + #: A constant which can be used with the type property of a RemoveModelLockDetails. + #: This constant has a value of "FULL" + TYPE_FULL = "FULL" + + #: A constant which can be used with the type property of a RemoveModelLockDetails. + #: This constant has a value of "DELETE" + TYPE_DELETE = "DELETE" + + def __init__(self, **kwargs): + """ + Initializes a new RemoveModelLockDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this RemoveModelLockDetails. + Allowed values for this property are: "FULL", "DELETE" + :type type: str + + """ + self.swagger_types = { + 'type': 'str' + } + + self.attribute_map = { + 'type': 'type' + } + + self._type = None + + @property + def type(self): + """ + **[Required]** Gets the type of this RemoveModelLockDetails. + Type of the lock. + + Allowed values for this property are: "FULL", "DELETE" + + + :return: The type of this RemoveModelLockDetails. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this RemoveModelLockDetails. + Type of the lock. + + + :param type: The type of this RemoveModelLockDetails. + :type: str + """ + allowed_values = ["FULL", "DELETE"] + if not value_allowed_none_or_none_sentinel(type, allowed_values): + raise ValueError( + f"Invalid value for `type`, must be None or one of {allowed_values}" + ) + self._type = 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/ai_document/models/remove_project_lock_details.py b/src/oci/ai_document/models/remove_project_lock_details.py new file mode 100644 index 0000000000..100b546f6b --- /dev/null +++ b/src/oci/ai_document/models/remove_project_lock_details.py @@ -0,0 +1,88 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20221109 + + +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 RemoveProjectLockDetails(object): + """ + Request payload to remove lock to the resource. + """ + + #: A constant which can be used with the type property of a RemoveProjectLockDetails. + #: This constant has a value of "FULL" + TYPE_FULL = "FULL" + + #: A constant which can be used with the type property of a RemoveProjectLockDetails. + #: This constant has a value of "DELETE" + TYPE_DELETE = "DELETE" + + def __init__(self, **kwargs): + """ + Initializes a new RemoveProjectLockDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this RemoveProjectLockDetails. + Allowed values for this property are: "FULL", "DELETE" + :type type: str + + """ + self.swagger_types = { + 'type': 'str' + } + + self.attribute_map = { + 'type': 'type' + } + + self._type = None + + @property + def type(self): + """ + **[Required]** Gets the type of this RemoveProjectLockDetails. + Type of the lock. + + Allowed values for this property are: "FULL", "DELETE" + + + :return: The type of this RemoveProjectLockDetails. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this RemoveProjectLockDetails. + Type of the lock. + + + :param type: The type of this RemoveProjectLockDetails. + :type: str + """ + allowed_values = ["FULL", "DELETE"] + if not value_allowed_none_or_none_sentinel(type, allowed_values): + raise ValueError( + f"Invalid value for `type`, must be None or one of {allowed_values}" + ) + self._type = 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/ai_document/models/resource_lock.py b/src/oci/ai_document/models/resource_lock.py new file mode 100644 index 0000000000..8c3deb3918 --- /dev/null +++ b/src/oci/ai_document/models/resource_lock.py @@ -0,0 +1,216 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20221109 + + +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 ResourceLock(object): + """ + Resource locks prevent certain APIs from being called for the resource. + A full lock prevents both updating and deleting the resource. A lock delete + prevents deleting the resource. + """ + + #: A constant which can be used with the type property of a ResourceLock. + #: This constant has a value of "FULL" + TYPE_FULL = "FULL" + + #: A constant which can be used with the type property of a ResourceLock. + #: This constant has a value of "DELETE" + TYPE_DELETE = "DELETE" + + def __init__(self, **kwargs): + """ + Initializes a new ResourceLock object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this ResourceLock. + Allowed values for this property are: "FULL", "DELETE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type type: str + + :param compartment_id: + The value to assign to the compartment_id property of this ResourceLock. + :type compartment_id: str + + :param related_resource_id: + The value to assign to the related_resource_id property of this ResourceLock. + :type related_resource_id: str + + :param message: + The value to assign to the message property of this ResourceLock. + :type message: str + + :param time_created: + The value to assign to the time_created property of this ResourceLock. + :type time_created: datetime + + """ + self.swagger_types = { + 'type': 'str', + 'compartment_id': 'str', + 'related_resource_id': 'str', + 'message': 'str', + 'time_created': 'datetime' + } + + self.attribute_map = { + 'type': 'type', + 'compartment_id': 'compartmentId', + 'related_resource_id': 'relatedResourceId', + 'message': 'message', + 'time_created': 'timeCreated' + } + + self._type = None + self._compartment_id = None + self._related_resource_id = None + self._message = None + self._time_created = None + + @property + def type(self): + """ + **[Required]** Gets the type of this ResourceLock. + Lock type. + + Allowed values for this property are: "FULL", "DELETE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The type of this ResourceLock. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this ResourceLock. + Lock type. + + + :param type: The type of this ResourceLock. + :type: str + """ + allowed_values = ["FULL", "DELETE"] + if not value_allowed_none_or_none_sentinel(type, allowed_values): + type = 'UNKNOWN_ENUM_VALUE' + self._type = type + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ResourceLock. + The lock compartment ID. + + + :return: The compartment_id of this ResourceLock. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ResourceLock. + The lock compartment ID. + + + :param compartment_id: The compartment_id of this ResourceLock. + :type: str + """ + self._compartment_id = compartment_id + + @property + def related_resource_id(self): + """ + Gets the related_resource_id of this ResourceLock. + The resource ID that is locking this resource. Indicates that deleting this resource removes the lock. + + + :return: The related_resource_id of this ResourceLock. + :rtype: str + """ + return self._related_resource_id + + @related_resource_id.setter + def related_resource_id(self, related_resource_id): + """ + Sets the related_resource_id of this ResourceLock. + The resource ID that is locking this resource. Indicates that deleting this resource removes the lock. + + + :param related_resource_id: The related_resource_id of this ResourceLock. + :type: str + """ + self._related_resource_id = related_resource_id + + @property + def message(self): + """ + Gets the message of this ResourceLock. + A message added by the lock creator. The message typically gives an + indication of why the resource is locked. + + + :return: The message of this ResourceLock. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this ResourceLock. + A message added by the lock creator. The message typically gives an + indication of why the resource is locked. + + + :param message: The message of this ResourceLock. + :type: str + """ + self._message = message + + @property + def time_created(self): + """ + Gets the time_created of this ResourceLock. + Indicates when the lock was created, in the format defined by RFC 3339. + + + :return: The time_created of this ResourceLock. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ResourceLock. + Indicates when the lock was created, in the format defined by RFC 3339. + + + :param time_created: The time_created of this ResourceLock. + :type: datetime + """ + self._time_created = time_created + + 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/announcements_service/__init__.py b/src/oci/announcements_service/__init__.py index ec486f910e..51215b3b01 100644 --- a/src/oci/announcements_service/__init__.py +++ b/src/oci/announcements_service/__init__.py @@ -13,6 +13,8 @@ from .announcement_subscription_client_composite_operations import AnnouncementSubscriptionClientCompositeOperations from .announcements_preferences_client import AnnouncementsPreferencesClient from .announcements_preferences_client_composite_operations import AnnouncementsPreferencesClientCompositeOperations +from .service_client import ServiceClient +from .service_client_composite_operations import ServiceClientCompositeOperations from . import models -__all__ = ["AnnouncementClient", "AnnouncementClientCompositeOperations", "AnnouncementSubscriptionClient", "AnnouncementSubscriptionClientCompositeOperations", "AnnouncementsPreferencesClient", "AnnouncementsPreferencesClientCompositeOperations", "models"] +__all__ = ["AnnouncementClient", "AnnouncementClientCompositeOperations", "AnnouncementSubscriptionClient", "AnnouncementSubscriptionClientCompositeOperations", "AnnouncementsPreferencesClient", "AnnouncementsPreferencesClientCompositeOperations", "ServiceClient", "ServiceClientCompositeOperations", "models"] diff --git a/src/oci/announcements_service/announcement_client.py b/src/oci/announcements_service/announcement_client.py index 1c2bcc9c44..07654084e8 100644 --- a/src/oci/announcements_service/announcement_client.py +++ b/src/oci/announcements_service/announcement_client.py @@ -215,6 +215,103 @@ def get_announcement(self, announcement_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) + def get_announcement_compartment(self, announcement_id, **kwargs): + """ + Gets the compartment details of an announcement. + + + :param str announcement_id: (required) + The OCID of the announcement. + + :param str opc_request_id: (optional) + The unique Oracle-assigned identifier for the request. If you need to contact Oracle about + a particular request, please provide the complete 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.announcements_service.models.AnnouncementCompartment` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_announcement_compartment API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['announcementId'] + resource_path = "/announcements/{announcementId}/compartment" + method = "GET" + operation_name = "get_announcement_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/announcements/0.0.1/AnnouncementCompartment/GetAnnouncementCompartment" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_announcement_compartment got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "announcementId": announcement_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="AnnouncementCompartment", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="AnnouncementCompartment", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def get_announcement_user_status(self, announcement_id, **kwargs): """ Gets information about whether a specific announcement was acknowledged by a user. @@ -366,7 +463,7 @@ def list_announcements(self, compartment_id, **kwargs): :param str platform_type: (optional) A filter to return only announcements affecting a specific platform. - Allowed values are: "IAAS", "SAAS" + Allowed values are: "IAAS", "SAAS", "PAAS" :param list[str] exclude_announcement_types: (optional) Exclude The type of announcement. @@ -454,7 +551,7 @@ def list_announcements(self, compartment_id, **kwargs): ) if 'platform_type' in kwargs: - platform_type_allowed_values = ["IAAS", "SAAS"] + platform_type_allowed_values = ["IAAS", "SAAS", "PAAS"] if kwargs['platform_type'] not in platform_type_allowed_values: raise ValueError( f"Invalid value for `platform_type`, must be one of { platform_type_allowed_values }" diff --git a/src/oci/announcements_service/models/__init__.py b/src/oci/announcements_service/models/__init__.py index 397935150d..b5cdf85a01 100644 --- a/src/oci/announcements_service/models/__init__.py +++ b/src/oci/announcements_service/models/__init__.py @@ -8,6 +8,7 @@ from .affected_resource import AffectedResource from .announcement import Announcement +from .announcement_compartment import AnnouncementCompartment from .announcement_subscription import AnnouncementSubscription from .announcement_subscription_collection import AnnouncementSubscriptionCollection from .announcement_subscription_summary import AnnouncementSubscriptionSummary @@ -19,6 +20,7 @@ from .base_announcement import BaseAnnouncement from .base_announcements_preferences import BaseAnnouncementsPreferences from .base_create_announcements_preferences_details import BaseCreateAnnouncementsPreferencesDetails +from .base_service import BaseService from .change_announcement_subscription_compartment_details import ChangeAnnouncementSubscriptionCompartmentDetails from .create_announcement_subscription_details import CreateAnnouncementSubscriptionDetails from .create_announcements_preferences_details import CreateAnnouncementsPreferencesDetails @@ -27,6 +29,10 @@ from .filter_group import FilterGroup from .filter_group_details import FilterGroupDetails from .model_property import ModelProperty +from .notifications_summary import NotificationsSummary +from .service import Service +from .service_summary import ServiceSummary +from .services_collection import ServicesCollection from .update_announcement_subscription_details import UpdateAnnouncementSubscriptionDetails from .update_announcements_preferences_details import UpdateAnnouncementsPreferencesDetails from .update_filter_group_details import UpdateFilterGroupDetails @@ -35,6 +41,7 @@ announcements_service_type_mapping = { "AffectedResource": AffectedResource, "Announcement": Announcement, + "AnnouncementCompartment": AnnouncementCompartment, "AnnouncementSubscription": AnnouncementSubscription, "AnnouncementSubscriptionCollection": AnnouncementSubscriptionCollection, "AnnouncementSubscriptionSummary": AnnouncementSubscriptionSummary, @@ -46,6 +53,7 @@ "BaseAnnouncement": BaseAnnouncement, "BaseAnnouncementsPreferences": BaseAnnouncementsPreferences, "BaseCreateAnnouncementsPreferencesDetails": BaseCreateAnnouncementsPreferencesDetails, + "BaseService": BaseService, "ChangeAnnouncementSubscriptionCompartmentDetails": ChangeAnnouncementSubscriptionCompartmentDetails, "CreateAnnouncementSubscriptionDetails": CreateAnnouncementSubscriptionDetails, "CreateAnnouncementsPreferencesDetails": CreateAnnouncementsPreferencesDetails, @@ -54,6 +62,10 @@ "FilterGroup": FilterGroup, "FilterGroupDetails": FilterGroupDetails, "ModelProperty": ModelProperty, + "NotificationsSummary": NotificationsSummary, + "Service": Service, + "ServiceSummary": ServiceSummary, + "ServicesCollection": ServicesCollection, "UpdateAnnouncementSubscriptionDetails": UpdateAnnouncementSubscriptionDetails, "UpdateAnnouncementsPreferencesDetails": UpdateAnnouncementsPreferencesDetails, "UpdateFilterGroupDetails": UpdateFilterGroupDetails diff --git a/src/oci/announcements_service/models/announcement.py b/src/oci/announcements_service/models/announcement.py index b23e93c24b..4459c2c947 100644 --- a/src/oci/announcements_service/models/announcement.py +++ b/src/oci/announcements_service/models/announcement.py @@ -103,7 +103,7 @@ def __init__(self, **kwargs): :param platform_type: The value to assign to the platform_type property of this Announcement. - Allowed values for this property are: "IAAS", "SAAS", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IAAS", "SAAS", "PAAS", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type platform_type: str diff --git a/src/oci/announcements_service/models/announcement_compartment.py b/src/oci/announcements_service/models/announcement_compartment.py new file mode 100644 index 0000000000..b8569ca112 --- /dev/null +++ b/src/oci/announcements_service/models/announcement_compartment.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + + +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 AnnouncementCompartment(object): + """ + Compartment details of an announcement. + """ + + def __init__(self, **kwargs): + """ + Initializes a new AnnouncementCompartment 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 AnnouncementCompartment. + :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 AnnouncementCompartment. + The OCID of the compartment to which the announcement belongs to. + + + :return: The compartment_id of this AnnouncementCompartment. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this AnnouncementCompartment. + The OCID of the compartment to which the announcement belongs to. + + + :param compartment_id: The compartment_id of this AnnouncementCompartment. + :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/announcements_service/models/announcement_summary.py b/src/oci/announcements_service/models/announcement_summary.py index 6e0b8b8c8d..753c9da0b6 100644 --- a/src/oci/announcements_service/models/announcement_summary.py +++ b/src/oci/announcements_service/models/announcement_summary.py @@ -103,7 +103,7 @@ def __init__(self, **kwargs): :param platform_type: The value to assign to the platform_type property of this AnnouncementSummary. - Allowed values for this property are: "IAAS", "SAAS", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IAAS", "SAAS", "PAAS", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type platform_type: str diff --git a/src/oci/announcements_service/models/base_announcement.py b/src/oci/announcements_service/models/base_announcement.py index 9aea00fe87..5567161973 100644 --- a/src/oci/announcements_service/models/base_announcement.py +++ b/src/oci/announcements_service/models/base_announcement.py @@ -123,6 +123,10 @@ class BaseAnnouncement(object): #: This constant has a value of "SAAS" PLATFORM_TYPE_SAAS = "SAAS" + #: A constant which can be used with the platform_type property of a BaseAnnouncement. + #: This constant has a value of "PAAS" + PLATFORM_TYPE_PAAS = "PAAS" + def __init__(self, **kwargs): """ Initializes a new BaseAnnouncement object with values from keyword arguments. This class has the following subclasses and if you are using this class as input @@ -211,7 +215,7 @@ def __init__(self, **kwargs): :param platform_type: The value to assign to the platform_type property of this BaseAnnouncement. - Allowed values for this property are: "IAAS", "SAAS" + Allowed values for this property are: "IAAS", "SAAS", "PAAS" :type platform_type: str :param chain_id: @@ -794,7 +798,7 @@ def platform_type(self): Gets the platform_type of this BaseAnnouncement. The platform type that this announcement pertains to. - Allowed values for this property are: "IAAS", "SAAS" + Allowed values for this property are: "IAAS", "SAAS", "PAAS" :return: The platform_type of this BaseAnnouncement. @@ -812,7 +816,7 @@ def platform_type(self, platform_type): :param platform_type: The platform_type of this BaseAnnouncement. :type: str """ - allowed_values = ["IAAS", "SAAS"] + allowed_values = ["IAAS", "SAAS", "PAAS"] if not value_allowed_none_or_none_sentinel(platform_type, allowed_values): raise ValueError( f"Invalid value for `platform_type`, must be None or one of {allowed_values}" diff --git a/src/oci/announcements_service/models/base_service.py b/src/oci/announcements_service/models/base_service.py new file mode 100644 index 0000000000..0b222e963d --- /dev/null +++ b/src/oci/announcements_service/models/base_service.py @@ -0,0 +1,498 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + + +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 BaseService(object): + """ + Object representing a single service. + """ + + #: A constant which can be used with the platform_type property of a BaseService. + #: This constant has a value of "IAAS" + PLATFORM_TYPE_IAAS = "IAAS" + + #: A constant which can be used with the platform_type property of a BaseService. + #: This constant has a value of "SAAS" + PLATFORM_TYPE_SAAS = "SAAS" + + #: A constant which can be used with the platform_type property of a BaseService. + #: This constant has a value of "PAAS" + PLATFORM_TYPE_PAAS = "PAAS" + + #: A constant which can be used with the comms_manager_name property of a BaseService. + #: This constant has a value of "CN" + COMMS_MANAGER_NAME_CN = "CN" + + #: A constant which can be used with the comms_manager_name property of a BaseService. + #: This constant has a value of "FUSION" + COMMS_MANAGER_NAME_FUSION = "FUSION" + + #: A constant which can be used with the comms_manager_name property of a BaseService. + #: This constant has a value of "AS" + COMMS_MANAGER_NAME_AS = "AS" + + #: A constant which can be used with the comms_manager_name property of a BaseService. + #: This constant has a value of "ERF" + COMMS_MANAGER_NAME_ERF = "ERF" + + #: A constant which can be used with the lifecycle_state property of a BaseService. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a BaseService. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + def __init__(self, **kwargs): + """ + Initializes a new BaseService 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.announcements_service.models.Service` + * :class:`~oci.announcements_service.models.ServiceSummary` + * :class:`~oci.announcements_service.models.NotificationsSummary` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this BaseService. + :type type: str + + :param id: + The value to assign to the id property of this BaseService. + :type id: str + + :param service_name: + The value to assign to the service_name property of this BaseService. + :type service_name: str + + :param short_name: + The value to assign to the short_name property of this BaseService. + :type short_name: str + + :param team_name: + The value to assign to the team_name property of this BaseService. + :type team_name: str + + :param platform_type: + The value to assign to the platform_type property of this BaseService. + Allowed values for this property are: "IAAS", "SAAS", "PAAS" + :type platform_type: str + + :param comms_manager_name: + The value to assign to the comms_manager_name property of this BaseService. + Allowed values for this property are: "CN", "FUSION", "AS", "ERF" + :type comms_manager_name: str + + :param excluded_realms: + The value to assign to the excluded_realms property of this BaseService. + :type excluded_realms: list[str] + + :param previous_service_names: + The value to assign to the previous_service_names property of this BaseService. + :type previous_service_names: list[str] + + :param time_created: + The value to assign to the time_created property of this BaseService. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this BaseService. + :type time_updated: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this BaseService. + Allowed values for this property are: "ACTIVE", "DELETED" + :type lifecycle_state: str + + """ + self.swagger_types = { + 'type': 'str', + 'id': 'str', + 'service_name': 'str', + 'short_name': 'str', + 'team_name': 'str', + 'platform_type': 'str', + 'comms_manager_name': 'str', + 'excluded_realms': 'list[str]', + 'previous_service_names': 'list[str]', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'id': 'id', + 'service_name': 'serviceName', + 'short_name': 'shortName', + 'team_name': 'teamName', + 'platform_type': 'platformType', + 'comms_manager_name': 'commsManagerName', + 'excluded_realms': 'excludedRealms', + 'previous_service_names': 'previousServiceNames', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'lifecycle_state': 'lifecycleState' + } + + self._type = None + self._id = None + self._service_name = None + self._short_name = None + self._team_name = None + self._platform_type = None + self._comms_manager_name = None + self._excluded_realms = None + self._previous_service_names = None + self._time_created = None + self._time_updated = None + self._lifecycle_state = 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['type'] + + if type == 'Service': + return 'Service' + + if type == 'ServiceSummary': + return 'ServiceSummary' + + if type == 'NotificationsSummary': + return 'NotificationsSummary' + else: + return 'BaseService' + + @property + def type(self): + """ + **[Required]** Gets the type of this BaseService. + The discriminator property. + + + :return: The type of this BaseService. + :rtype: str + """ + return self._type + + @type.setter + def type(self, type): + """ + Sets the type of this BaseService. + The discriminator property. + + + :param type: The type of this BaseService. + :type: str + """ + self._type = type + + @property + def id(self): + """ + **[Required]** Gets the id of this BaseService. + ID of the service object. + + + :return: The id of this BaseService. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this BaseService. + ID of the service object. + + + :param id: The id of this BaseService. + :type: str + """ + self._id = id + + @property + def service_name(self): + """ + **[Required]** Gets the service_name of this BaseService. + Name of the service represented by this object. + + + :return: The service_name of this BaseService. + :rtype: str + """ + return self._service_name + + @service_name.setter + def service_name(self, service_name): + """ + Sets the service_name of this BaseService. + Name of the service represented by this object. + + + :param service_name: The service_name of this BaseService. + :type: str + """ + self._service_name = service_name + + @property + def short_name(self): + """ + **[Required]** Gets the short_name of this BaseService. + Short name of the team to whom this service object is related. + + + :return: The short_name of this BaseService. + :rtype: str + """ + return self._short_name + + @short_name.setter + def short_name(self, short_name): + """ + Sets the short_name of this BaseService. + Short name of the team to whom this service object is related. + + + :param short_name: The short_name of this BaseService. + :type: str + """ + self._short_name = short_name + + @property + def team_name(self): + """ + **[Required]** Gets the team_name of this BaseService. + Team name to which this service object is related. + + + :return: The team_name of this BaseService. + :rtype: str + """ + return self._team_name + + @team_name.setter + def team_name(self, team_name): + """ + Sets the team_name of this BaseService. + Team name to which this service object is related. + + + :param team_name: The team_name of this BaseService. + :type: str + """ + self._team_name = team_name + + @property + def platform_type(self): + """ + **[Required]** Gets the platform_type of this BaseService. + The platform type this service object is related to. + + Allowed values for this property are: "IAAS", "SAAS", "PAAS" + + + :return: The platform_type of this BaseService. + :rtype: str + """ + return self._platform_type + + @platform_type.setter + def platform_type(self, platform_type): + """ + Sets the platform_type of this BaseService. + The platform type this service object is related to. + + + :param platform_type: The platform_type of this BaseService. + :type: str + """ + allowed_values = ["IAAS", "SAAS", "PAAS"] + if not value_allowed_none_or_none_sentinel(platform_type, allowed_values): + raise ValueError( + f"Invalid value for `platform_type`, must be None or one of {allowed_values}" + ) + self._platform_type = platform_type + + @property + def comms_manager_name(self): + """ + **[Required]** Gets the comms_manager_name of this BaseService. + Name of the comms manager team that manages Notifications to this service. + + Allowed values for this property are: "CN", "FUSION", "AS", "ERF" + + + :return: The comms_manager_name of this BaseService. + :rtype: str + """ + return self._comms_manager_name + + @comms_manager_name.setter + def comms_manager_name(self, comms_manager_name): + """ + Sets the comms_manager_name of this BaseService. + Name of the comms manager team that manages Notifications to this service. + + + :param comms_manager_name: The comms_manager_name of this BaseService. + :type: str + """ + allowed_values = ["CN", "FUSION", "AS", "ERF"] + if not value_allowed_none_or_none_sentinel(comms_manager_name, allowed_values): + raise ValueError( + f"Invalid value for `comms_manager_name`, must be None or one of {allowed_values}" + ) + self._comms_manager_name = comms_manager_name + + @property + def excluded_realms(self): + """ + **[Required]** Gets the excluded_realms of this BaseService. + The list of realms where this service is not available to be used. + + + :return: The excluded_realms of this BaseService. + :rtype: list[str] + """ + return self._excluded_realms + + @excluded_realms.setter + def excluded_realms(self, excluded_realms): + """ + Sets the excluded_realms of this BaseService. + The list of realms where this service is not available to be used. + + + :param excluded_realms: The excluded_realms of this BaseService. + :type: list[str] + """ + self._excluded_realms = excluded_realms + + @property + def previous_service_names(self): + """ + **[Required]** Gets the previous_service_names of this BaseService. + The list of previously used names for this service object. + + + :return: The previous_service_names of this BaseService. + :rtype: list[str] + """ + return self._previous_service_names + + @previous_service_names.setter + def previous_service_names(self, previous_service_names): + """ + Sets the previous_service_names of this BaseService. + The list of previously used names for this service object. + + + :param previous_service_names: The previous_service_names of this BaseService. + :type: list[str] + """ + self._previous_service_names = previous_service_names + + @property + def time_created(self): + """ + Gets the time_created of this BaseService. + The date and time when the service object was created. + + + :return: The time_created of this BaseService. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this BaseService. + The date and time when the service object was created. + + + :param time_created: The time_created of this BaseService. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this BaseService. + The date and time when the service object was updated. + + + :return: The time_updated of this BaseService. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this BaseService. + The date and time when the service object was updated. + + + :param time_updated: The time_updated of this BaseService. + :type: datetime + """ + self._time_updated = time_updated + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this BaseService. + Current state of the service object. + + Allowed values for this property are: "ACTIVE", "DELETED" + + + :return: The lifecycle_state of this BaseService. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this BaseService. + Current state of the service object. + + + :param lifecycle_state: The lifecycle_state of this BaseService. + :type: str + """ + allowed_values = ["ACTIVE", "DELETED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + raise ValueError( + f"Invalid value for `lifecycle_state`, must be None or one of {allowed_values}" + ) + 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/announcements_service/models/notifications_summary.py b/src/oci/announcements_service/models/notifications_summary.py new file mode 100644 index 0000000000..a95cf2292d --- /dev/null +++ b/src/oci/announcements_service/models/notifications_summary.py @@ -0,0 +1,130 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + +from .base_service import BaseService +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 NotificationsSummary(BaseService): + """ + Summary of notification object, return by List API + """ + + def __init__(self, **kwargs): + """ + Initializes a new NotificationsSummary object with values from keyword arguments. The default value of the :py:attr:`~oci.announcements_service.models.NotificationsSummary.type` attribute + of this class is ``NotificationsSummary`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this NotificationsSummary. + :type type: str + + :param id: + The value to assign to the id property of this NotificationsSummary. + :type id: str + + :param service_name: + The value to assign to the service_name property of this NotificationsSummary. + :type service_name: str + + :param short_name: + The value to assign to the short_name property of this NotificationsSummary. + :type short_name: str + + :param team_name: + The value to assign to the team_name property of this NotificationsSummary. + :type team_name: str + + :param platform_type: + The value to assign to the platform_type property of this NotificationsSummary. + Allowed values for this property are: "IAAS", "SAAS", "PAAS" + :type platform_type: str + + :param comms_manager_name: + The value to assign to the comms_manager_name property of this NotificationsSummary. + Allowed values for this property are: "CN", "FUSION", "AS", "ERF" + :type comms_manager_name: str + + :param excluded_realms: + The value to assign to the excluded_realms property of this NotificationsSummary. + :type excluded_realms: list[str] + + :param previous_service_names: + The value to assign to the previous_service_names property of this NotificationsSummary. + :type previous_service_names: list[str] + + :param time_created: + The value to assign to the time_created property of this NotificationsSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this NotificationsSummary. + :type time_updated: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this NotificationsSummary. + Allowed values for this property are: "ACTIVE", "DELETED" + :type lifecycle_state: str + + """ + self.swagger_types = { + 'type': 'str', + 'id': 'str', + 'service_name': 'str', + 'short_name': 'str', + 'team_name': 'str', + 'platform_type': 'str', + 'comms_manager_name': 'str', + 'excluded_realms': 'list[str]', + 'previous_service_names': 'list[str]', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'id': 'id', + 'service_name': 'serviceName', + 'short_name': 'shortName', + 'team_name': 'teamName', + 'platform_type': 'platformType', + 'comms_manager_name': 'commsManagerName', + 'excluded_realms': 'excludedRealms', + 'previous_service_names': 'previousServiceNames', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'lifecycle_state': 'lifecycleState' + } + + self._type = None + self._id = None + self._service_name = None + self._short_name = None + self._team_name = None + self._platform_type = None + self._comms_manager_name = None + self._excluded_realms = None + self._previous_service_names = None + self._time_created = None + self._time_updated = None + self._lifecycle_state = None + self._type = 'NotificationsSummary' + + 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/announcements_service/models/service.py b/src/oci/announcements_service/models/service.py new file mode 100644 index 0000000000..ae9fa54b5a --- /dev/null +++ b/src/oci/announcements_service/models/service.py @@ -0,0 +1,130 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + +from .base_service import BaseService +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 Service(BaseService): + """ + Summary of the service object. + """ + + def __init__(self, **kwargs): + """ + Initializes a new Service object with values from keyword arguments. The default value of the :py:attr:`~oci.announcements_service.models.Service.type` attribute + of this class is ``Service`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this Service. + :type type: str + + :param id: + The value to assign to the id property of this Service. + :type id: str + + :param service_name: + The value to assign to the service_name property of this Service. + :type service_name: str + + :param short_name: + The value to assign to the short_name property of this Service. + :type short_name: str + + :param team_name: + The value to assign to the team_name property of this Service. + :type team_name: str + + :param platform_type: + The value to assign to the platform_type property of this Service. + Allowed values for this property are: "IAAS", "SAAS", "PAAS" + :type platform_type: str + + :param comms_manager_name: + The value to assign to the comms_manager_name property of this Service. + Allowed values for this property are: "CN", "FUSION", "AS", "ERF" + :type comms_manager_name: str + + :param excluded_realms: + The value to assign to the excluded_realms property of this Service. + :type excluded_realms: list[str] + + :param previous_service_names: + The value to assign to the previous_service_names property of this Service. + :type previous_service_names: list[str] + + :param time_created: + The value to assign to the time_created property of this Service. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this Service. + :type time_updated: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this Service. + Allowed values for this property are: "ACTIVE", "DELETED" + :type lifecycle_state: str + + """ + self.swagger_types = { + 'type': 'str', + 'id': 'str', + 'service_name': 'str', + 'short_name': 'str', + 'team_name': 'str', + 'platform_type': 'str', + 'comms_manager_name': 'str', + 'excluded_realms': 'list[str]', + 'previous_service_names': 'list[str]', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'id': 'id', + 'service_name': 'serviceName', + 'short_name': 'shortName', + 'team_name': 'teamName', + 'platform_type': 'platformType', + 'comms_manager_name': 'commsManagerName', + 'excluded_realms': 'excludedRealms', + 'previous_service_names': 'previousServiceNames', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'lifecycle_state': 'lifecycleState' + } + + self._type = None + self._id = None + self._service_name = None + self._short_name = None + self._team_name = None + self._platform_type = None + self._comms_manager_name = None + self._excluded_realms = None + self._previous_service_names = None + self._time_created = None + self._time_updated = None + self._lifecycle_state = None + self._type = 'Service' + + 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/announcements_service/models/service_summary.py b/src/oci/announcements_service/models/service_summary.py new file mode 100644 index 0000000000..c68711ebc5 --- /dev/null +++ b/src/oci/announcements_service/models/service_summary.py @@ -0,0 +1,133 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + +from .base_service import BaseService +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 ServiceSummary(BaseService): + """ + Summary of the service object. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceSummary object with values from keyword arguments. The default value of the :py:attr:`~oci.announcements_service.models.ServiceSummary.type` attribute + of this class is ``ServiceSummary`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this ServiceSummary. + :type type: str + + :param id: + The value to assign to the id property of this ServiceSummary. + :type id: str + + :param service_name: + The value to assign to the service_name property of this ServiceSummary. + :type service_name: str + + :param short_name: + The value to assign to the short_name property of this ServiceSummary. + :type short_name: str + + :param team_name: + The value to assign to the team_name property of this ServiceSummary. + :type team_name: str + + :param platform_type: + The value to assign to the platform_type property of this ServiceSummary. + Allowed values for this property are: "IAAS", "SAAS", "PAAS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type platform_type: str + + :param comms_manager_name: + The value to assign to the comms_manager_name property of this ServiceSummary. + Allowed values for this property are: "CN", "FUSION", "AS", "ERF", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type comms_manager_name: str + + :param excluded_realms: + The value to assign to the excluded_realms property of this ServiceSummary. + :type excluded_realms: list[str] + + :param previous_service_names: + The value to assign to the previous_service_names property of this ServiceSummary. + :type previous_service_names: list[str] + + :param time_created: + The value to assign to the time_created property of this ServiceSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ServiceSummary. + :type time_updated: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ServiceSummary. + Allowed values for this property are: "ACTIVE", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + """ + self.swagger_types = { + 'type': 'str', + 'id': 'str', + 'service_name': 'str', + 'short_name': 'str', + 'team_name': 'str', + 'platform_type': 'str', + 'comms_manager_name': 'str', + 'excluded_realms': 'list[str]', + 'previous_service_names': 'list[str]', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'id': 'id', + 'service_name': 'serviceName', + 'short_name': 'shortName', + 'team_name': 'teamName', + 'platform_type': 'platformType', + 'comms_manager_name': 'commsManagerName', + 'excluded_realms': 'excludedRealms', + 'previous_service_names': 'previousServiceNames', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'lifecycle_state': 'lifecycleState' + } + + self._type = None + self._id = None + self._service_name = None + self._short_name = None + self._team_name = None + self._platform_type = None + self._comms_manager_name = None + self._excluded_realms = None + self._previous_service_names = None + self._time_created = None + self._time_updated = None + self._lifecycle_state = None + self._type = 'ServiceSummary' + + 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/announcements_service/models/services_collection.py b/src/oci/announcements_service/models/services_collection.py new file mode 100644 index 0000000000..80aa2a9f7f --- /dev/null +++ b/src/oci/announcements_service/models/services_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + + +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 ServicesCollection(object): + """ + Collection of all services. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServicesCollection 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 ServicesCollection. + :type items: list[oci.announcements_service.models.ServiceSummary] + + """ + self.swagger_types = { + 'items': 'list[ServiceSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ServicesCollection. + List of all services. + + + :return: The items of this ServicesCollection. + :rtype: list[oci.announcements_service.models.ServiceSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ServicesCollection. + List of all services. + + + :param items: The items of this ServicesCollection. + :type: list[oci.announcements_service.models.ServiceSummary] + """ + 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/announcements_service/service_client.py b/src/oci/announcements_service/service_client.py new file mode 100644 index 0000000000..40dfaa7b71 --- /dev/null +++ b/src/oci/announcements_service/service_client.py @@ -0,0 +1,275 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + +from __future__ import absolute_import + +from oci._vendor import requests # noqa: F401 +from oci._vendor import six + +from oci import retry, circuit_breaker # noqa: F401 +from oci.base_client import BaseClient +from oci.config import get_config_value_or_default, validate_config +from oci.signer import Signer +from oci.util import Sentinel, get_signer_from_authentication_type, AUTHENTICATION_TYPE_FIELD_NAME +from oci.exceptions import InvalidAlloyConfig +from oci.alloy import OCI_SDK_ENABLED_SERVICES_SET +from .models import announcements_service_type_mapping +missing = Sentinel("Missing") + + +class ServiceClient(object): + """ + Manage Oracle Cloud Infrastructure console announcements. + """ + + def __init__(self, config, **kwargs): + """ + Creates a new service client + + :param dict config: + Configuration keys and values as per `SDK and Tool Configuration `__. + The :py:meth:`~oci.config.from_file` method can be used to load configuration from a file. Alternatively, a ``dict`` can be passed. You can validate_config + the dict using :py:meth:`~oci.config.validate_config` + + :param str service_endpoint: (optional) + The endpoint of the service to call using this client. For example ``https://iaas.us-ashburn-1.oraclecloud.com``. If this keyword argument is + not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit + need to specify a service endpoint. + + :param timeout: (optional) + The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided + as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If + a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout. + :type timeout: float or tuple(float, float) + + :param signer: (optional) + The signer to use when signing requests made by the service client. The default is to use a :py:class:`~oci.signer.Signer` based on the values + provided in the config parameter. + + One use case for this parameter is for `Instance Principals authentication `__ + by passing an instance of :py:class:`~oci.auth.signers.InstancePrincipalsSecurityTokenSigner` as the value for this keyword argument + :type signer: :py:class:`~oci.signer.AbstractBaseSigner` + + :param obj retry_strategy: (optional) + A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. + Retry strategies can also be applied at the operation level by passing a ``retry_strategy`` keyword argument as part of calling the operation. + Any value provided at the operation level will override whatever is specified at the client level. + + This should be one of the strategies available in the :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 obj circuit_breaker_strategy: (optional) + A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level). + This client uses :py:data:`~oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY` as default if no circuit breaker strategy is provided. + The specifics of circuit breaker strategy are described `here `__. + + :param function circuit_breaker_callback: (optional) + Callback function to receive any exceptions triggerred by the circuit breaker. + + :param bool client_level_realm_specific_endpoint_template_enabled: (optional) + A boolean flag to indicate whether or not this client should be created with realm specific endpoint template enabled or disable. By default, this will be set as None. + + :param allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not + allow control characters to be in the response object. + """ + if not OCI_SDK_ENABLED_SERVICES_SET.is_service_enabled("announcements_service"): + raise InvalidAlloyConfig("The Alloy configuration has disabled this service, this behavior is controlled by OCI_SDK_ENABLED_SERVICES_SET variable. Please check if your local alloy-config file configured the service you're targeting or contact the cloud provider on the availability of this service") + + validate_config(config, signer=kwargs.get('signer')) + if 'signer' in kwargs: + signer = kwargs['signer'] + + elif AUTHENTICATION_TYPE_FIELD_NAME in config: + signer = get_signer_from_authentication_type(config) + + else: + signer = Signer( + tenancy=config["tenancy"], + user=config["user"], + fingerprint=config["fingerprint"], + private_key_file_location=config.get("key_file"), + pass_phrase=get_config_value_or_default(config, "pass_phrase"), + private_key_content=config.get("key_content") + ) + + base_client_init_kwargs = { + 'regional_client': True, + 'service_endpoint': kwargs.get('service_endpoint'), + 'base_path': '/20180904', + 'service_endpoint_template': 'https://announcements.{region}.{secondLevelDomain}', + 'service_endpoint_template_per_realm': { }, # noqa: E201 E202 + 'skip_deserialization': kwargs.get('skip_deserialization', False), + 'circuit_breaker_strategy': kwargs.get('circuit_breaker_strategy', circuit_breaker.GLOBAL_CIRCUIT_BREAKER_STRATEGY), + 'client_level_realm_specific_endpoint_template_enabled': kwargs.get('client_level_realm_specific_endpoint_template_enabled') + } + if 'timeout' in kwargs: + base_client_init_kwargs['timeout'] = kwargs.get('timeout') + if base_client_init_kwargs.get('circuit_breaker_strategy') is None: + base_client_init_kwargs['circuit_breaker_strategy'] = circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY + if 'allow_control_chars' in kwargs: + base_client_init_kwargs['allow_control_chars'] = kwargs.get('allow_control_chars') + self.base_client = BaseClient("service", config, signer, announcements_service_type_mapping, **base_client_init_kwargs) + self.retry_strategy = kwargs.get('retry_strategy') + self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback') + + def list_services(self, compartment_id, **kwargs): + """ + List all active services + + + :param str compartment_id: (required) + The OCID of the compartment. + + :param str platform_type: (optional) + A filter to return only announcements affecting a specific platform. + + Allowed values are: "IAAS", "SAAS", "PAAS" + + :param str comms_manager_name: (optional) + Filter by comms manager name + + Allowed values are: "CN", "FUSION", "AS", "ERF" + + :param int limit: (optional) + The maximum number of items to return in a paginated \"List\" call. + + :param str page: (optional) + The value of the `opc-next-page` response header from the previous \"List\" call. + + :param str sort_by: (optional) + Sort by service name parameter + + Allowed values are: "serviceName" + + :param str sort_order: (optional) + The sort order to use, whether ascending ('ASC') or descending ('DESC'). + + Allowed values are: "ASC", "DESC" + + :param str opc_request_id: (optional) + The unique Oracle-assigned identifier for the request. If you need to contact Oracle about + a particular request, please provide the complete 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.announcements_service.models.ServicesCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_services API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/services" + method = "GET" + operation_name = "list_services" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/announcements/0.0.1/Service/ListServices" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "platform_type", + "comms_manager_name", + "limit", + "page", + "sort_by", + "sort_order", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_services got unknown kwargs: {extra_kwargs!r}") + + if 'platform_type' in kwargs: + platform_type_allowed_values = ["IAAS", "SAAS", "PAAS"] + if kwargs['platform_type'] not in platform_type_allowed_values: + raise ValueError( + f"Invalid value for `platform_type`, must be one of { platform_type_allowed_values }" + ) + + if 'comms_manager_name' in kwargs: + comms_manager_name_allowed_values = ["CN", "FUSION", "AS", "ERF"] + if kwargs['comms_manager_name'] not in comms_manager_name_allowed_values: + raise ValueError( + f"Invalid value for `comms_manager_name`, must be one of { comms_manager_name_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["serviceName"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + query_params = { + "platformType": kwargs.get("platform_type", missing), + "commsManagerName": kwargs.get("comms_manager_name", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortBy": kwargs.get("sort_by", missing), + "sortOrder": kwargs.get("sort_order", 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) + } + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServicesCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="ServicesCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) diff --git a/src/oci/announcements_service/service_client_composite_operations.py b/src/oci/announcements_service/service_client_composite_operations.py new file mode 100644 index 0000000000..be10f14838 --- /dev/null +++ b/src/oci/announcements_service/service_client_composite_operations.py @@ -0,0 +1,26 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 0.0.1 + +import oci # noqa: F401 +from oci.util import WAIT_RESOURCE_NOT_FOUND # noqa: F401 + + +class ServiceClientCompositeOperations(object): + """ + This class provides a wrapper around :py:class:`~oci.announcements_service.ServiceClient` and offers convenience methods + for operations that would otherwise need to be chained together. For example, instead of performing an action + on a resource (e.g. launching an instance, creating a load balancer) and then using a waiter to wait for the resource + to enter a given state, you can call a single method in this class to accomplish the same functionality + """ + + def __init__(self, client, **kwargs): + """ + Creates a new ServiceClientCompositeOperations object + + :param ServiceClient client: + The service client which will be wrapped by this object + """ + self.client = client diff --git a/src/oci/database/database_client.py b/src/oci/database/database_client.py index a1b3dd7f01..fe6d2f4943 100644 --- a/src/oci/database/database_client.py +++ b/src/oci/database/database_client.py @@ -934,22 +934,26 @@ def cancel_backup(self, backup_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_container_database_compartment(self, change_compartment_details, autonomous_container_database_id, **kwargs): + def cancel_execution_window(self, execution_window_id, cancel_execution_window_details, **kwargs): """ - Move the Autonomous Container Database and its dependent resources to the specified compartment. - For more information about moving Autonomous Container Databases, see - `Moving Database Resources to a Different Compartment`__. + Cancels the in progress maintenance activity under this execution window. - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes + :param str execution_window_id: (required) + The execution window `OCID`__. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move Autonomous Container Database to a different compartment + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param oci.database.models.CancelExecutionWindowDetails cancel_execution_window_details: (required) + Request to cancel the in progress maintenance activity under this execution window. - __ 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 @@ -958,14 +962,6 @@ def change_autonomous_container_database_compartment(self, change_compartment_de 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. @@ -978,34 +974,34 @@ def change_autonomous_container_database_compartment(self, change_compartment_de allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionWindow` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_container_database_compartment API. + Click `here `__ to see an example of how to use cancel_execution_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeCompartment" + required_arguments = ['executionWindowId'] + resource_path = "/executionWindows/{executionWindowId}/actions/cancel" method = "POST" - operation_name = "change_autonomous_container_database_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ChangeAutonomousContainerDatabaseCompartment" + operation_name = "cancel_execution_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/CancelExecutionWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", + "if_match", "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( - f"change_autonomous_container_database_compartment got unknown kwargs: {extra_kwargs!r}") + f"cancel_execution_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "executionWindowId": execution_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1017,9 +1013,9 @@ def change_autonomous_container_database_compartment(self, change_compartment_de 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-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} @@ -1039,7 +1035,8 @@ def change_autonomous_container_database_compartment(self, change_compartment_de method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=cancel_execution_window_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1050,26 +1047,20 @@ def change_autonomous_container_database_compartment(self, change_compartment_de method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=cancel_execution_window_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_database_compartment(self, change_compartment_details, autonomous_database_id, **kwargs): + def cascading_delete_scheduling_plan(self, scheduling_plan_id, **kwargs): """ - Move the Autonomous Database and its dependent resources to the specified compartment. - For more information about moving Autonomous Databases, see - `Moving Database Resources to a Different Compartment`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - + Delete the scheduling plan resource along with all the scheduled actions associated with this resource. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move Autonomous Database to a different compartment - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str scheduling_plan_id: (required) + The Schedule Plan `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1080,14 +1071,14 @@ def change_autonomous_database_compartment(self, change_compartment_details, aut 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 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. @@ -1104,30 +1095,30 @@ def change_autonomous_database_compartment(self, change_compartment_details, aut :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_database_compartment API. + Click `here `__ to see an example of how to use cascading_delete_scheduling_plan API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeCompartment" + required_arguments = ['schedulingPlanId'] + resource_path = "/schedulingPlans/{schedulingPlanId}/actions/cascadingDeleteSchedulingPlan" method = "POST" - operation_name = "change_autonomous_database_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeAutonomousDatabaseCompartment" + operation_name = "cascading_delete_scheduling_plan" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/CascadingDeleteSchedulingPlan" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "opc_retry_token", - "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( - f"change_autonomous_database_compartment got unknown kwargs: {extra_kwargs!r}") + f"cascading_delete_scheduling_plan got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "schedulingPlanId": scheduling_plan_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1140,8 +1131,8 @@ def change_autonomous_database_compartment(self, change_compartment_details, aut "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) + "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} @@ -1161,7 +1152,6 @@ def change_autonomous_database_compartment(self, change_compartment_details, aut method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1172,22 +1162,25 @@ def change_autonomous_database_compartment(self, change_compartment_details, aut method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_database_software_image_compartment(self, change_autonomous_database_software_image_compartment_details, autonomous_database_software_image_id, **kwargs): + def change_autonomous_container_database_compartment(self, change_compartment_details, autonomous_container_database_id, **kwargs): """ - Move the Autonomous Database Software Image and its dependent resources to the specified compartment. + Move the Autonomous Container Database and its dependent resources to the specified compartment. + For more information about moving Autonomous 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.ChangeAutonomousDatabaseSoftwareImageCompartmentDetails change_autonomous_database_software_image_compartment_details: (required) - Request to move Autonomous Database Software Image to a different compartment + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move Autonomous Container Database to a different compartment - :param str autonomous_database_software_image_id: (required) - The Autonomous Database Software Image `OCID`__. + :param str autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1222,14 +1215,14 @@ def change_autonomous_database_software_image_compartment(self, change_autonomou :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_database_software_image_compartment API. + Click `here `__ to see an example of how to use change_autonomous_container_database_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseSoftwareImageId'] - resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}/actions/changeCompartment" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeCompartment" method = "POST" - operation_name = "change_autonomous_database_software_image_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/ChangeAutonomousDatabaseSoftwareImageCompartment" + operation_name = "change_autonomous_container_database_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ChangeAutonomousContainerDatabaseCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1242,10 +1235,10 @@ def change_autonomous_database_software_image_compartment(self, change_autonomou extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_autonomous_database_software_image_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_container_database_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1279,7 +1272,7 @@ def change_autonomous_database_software_image_compartment(self, change_autonomou method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_database_software_image_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1290,19 +1283,23 @@ def change_autonomous_database_software_image_compartment(self, change_autonomou method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_database_software_image_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_database_subscription(self, change_autonomous_database_subscription_details, autonomous_database_id, **kwargs): + def change_autonomous_database_compartment(self, change_compartment_details, autonomous_database_id, **kwargs): """ - Associate an Autonomous Database with a different subscription. + Move the Autonomous Database and its dependent resources to the specified compartment. + For more information about moving Autonomous Databases, see + `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeAutonomousDatabaseSubscriptionDetails change_autonomous_database_subscription_details: (required) - Associate an Autonomous Database with a different subscription. + + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move Autonomous Database to a different compartment :param str autonomous_database_id: (required) The database `OCID`__. @@ -1340,14 +1337,14 @@ def change_autonomous_database_subscription(self, change_autonomous_database_sub :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_database_subscription API. + Click `here `__ to see an example of how to use change_autonomous_database_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeSubscription" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeCompartment" method = "POST" - operation_name = "change_autonomous_database_subscription" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeAutonomousDatabaseSubscription" + operation_name = "change_autonomous_database_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeAutonomousDatabaseCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1360,7 +1357,7 @@ def change_autonomous_database_subscription(self, change_autonomous_database_sub extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_autonomous_database_subscription got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_database_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { "autonomousDatabaseId": autonomous_database_id @@ -1397,7 +1394,7 @@ def change_autonomous_database_subscription(self, change_autonomous_database_sub method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_database_subscription_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1408,26 +1405,22 @@ def change_autonomous_database_subscription(self, change_autonomous_database_sub method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_database_subscription_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_exadata_infrastructure_compartment(self, change_compartment_details, autonomous_exadata_infrastructure_id, **kwargs): + def change_autonomous_database_software_image_compartment(self, change_autonomous_database_software_image_compartment_details, autonomous_database_software_image_id, **kwargs): """ - **Deprecated.** Use the :func:`change_cloud_exadata_infrastructure_compartment` operation to move an Exadata infrastructure resource to a different compartment and :func:`change_cloud_autonomous_vm_cluster_compartment` operation to move an Autonomous Exadata VM cluster to a different compartment. - For more information, see - `Moving Database Resources to a Different Compartment`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes + Move the Autonomous Database Software Image and its dependent resources to the specified compartment. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move an Autonomous Exadata Infrastructure resource to a different compartment. + :param oci.database.models.ChangeAutonomousDatabaseSoftwareImageCompartmentDetails change_autonomous_database_software_image_compartment_details: (required) + Request to move Autonomous Database Software Image to a different compartment - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str autonomous_database_software_image_id: (required) + The Autonomous Database Software Image `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1462,14 +1455,14 @@ def change_autonomous_exadata_infrastructure_compartment(self, change_compartmen :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_exadata_infrastructure_compartment API. + Click `here `__ to see an example of how to use change_autonomous_database_software_image_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/changeCompartment" + required_arguments = ['autonomousDatabaseSoftwareImageId'] + resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}/actions/changeCompartment" method = "POST" - operation_name = "change_autonomous_exadata_infrastructure_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/ChangeAutonomousExadataInfrastructureCompartment" + operation_name = "change_autonomous_database_software_image_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/ChangeAutonomousDatabaseSoftwareImageCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1482,10 +1475,10 @@ def change_autonomous_exadata_infrastructure_compartment(self, change_compartmen extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_autonomous_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_database_software_image_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1519,7 +1512,7 @@ def change_autonomous_exadata_infrastructure_compartment(self, change_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_autonomous_database_software_image_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1530,22 +1523,22 @@ def change_autonomous_exadata_infrastructure_compartment(self, change_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_autonomous_database_software_image_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_compartment_details, autonomous_vm_cluster_id, **kwargs): + def change_autonomous_database_subscription(self, change_autonomous_database_subscription_details, autonomous_database_id, **kwargs): """ - Moves an Autonomous VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer only. For systems in the Oracle cloud, see :func:`change_autonomous_vm_cluster_compartment`. + Associate an Autonomous Database with a different subscription. - :param oci.database.models.ChangeAutonomousVmClusterCompartmentDetails change_autonomous_vm_cluster_compartment_details: (required) - Request to move Autonomous VM cluster to a different compartment + :param oci.database.models.ChangeAutonomousDatabaseSubscriptionDetails change_autonomous_database_subscription_details: (required) + Associate an Autonomous Database with a different subscription. - :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 @@ -1580,14 +1573,14 @@ def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_autonomous_vm_cluster_compartment API. + Click `here `__ to see an example of how to use change_autonomous_database_subscription API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/changeCompartment" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeSubscription" method = "POST" - operation_name = "change_autonomous_vm_cluster_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ChangeAutonomousVmClusterCompartment" + operation_name = "change_autonomous_database_subscription" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeAutonomousDatabaseSubscription" # Don't accept unknown kwargs expected_kwargs = [ @@ -1600,10 +1593,10 @@ def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_autonomous_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_database_subscription got unknown kwargs: {extra_kwargs!r}") 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} @@ -1637,7 +1630,7 @@ def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_ method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_vm_cluster_compartment_details, + body=change_autonomous_database_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1648,15 +1641,15 @@ def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_ method=method, path_params=path_params, header_params=header_params, - body=change_autonomous_vm_cluster_compartment_details, + body=change_autonomous_database_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_backup_destination_compartment(self, change_compartment_details, backup_destination_id, **kwargs): + def change_autonomous_exadata_infrastructure_compartment(self, change_compartment_details, autonomous_exadata_infrastructure_id, **kwargs): """ - Move the backup destination and its dependent resources to the specified compartment. + **Deprecated.** Use the :func:`change_cloud_exadata_infrastructure_compartment` operation to move an Exadata infrastructure resource to a different compartment and :func:`change_cloud_autonomous_vm_cluster_compartment` operation to move an Autonomous Exadata VM cluster to a different compartment. For more information, see `Moving Database Resources to a Different Compartment`__. @@ -1664,10 +1657,10 @@ def change_backup_destination_compartment(self, change_compartment_details, back :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move backup destination to a different compartment. + Request to move an Autonomous Exadata Infrastructure resource to a different compartment. - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1702,14 +1695,14 @@ def change_backup_destination_compartment(self, change_compartment_details, back :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_backup_destination_compartment API. + Click `here `__ to see an example of how to use change_autonomous_exadata_infrastructure_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupDestinationId'] - resource_path = "/backupDestinations/{backupDestinationId}/actions/changeCompartment" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/changeCompartment" method = "POST" - operation_name = "change_backup_destination_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/ChangeBackupDestinationCompartment" + operation_name = "change_autonomous_exadata_infrastructure_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/ChangeAutonomousExadataInfrastructureCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1722,10 +1715,10 @@ def change_backup_destination_compartment(self, change_compartment_details, back extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_backup_destination_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupDestinationId": backup_destination_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1776,16 +1769,16 @@ def change_backup_destination_compartment(self, change_compartment_details, back api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous_vm_cluster_compartment_details, cloud_autonomous_vm_cluster_id, **kwargs): + def change_autonomous_vm_cluster_compartment(self, change_autonomous_vm_cluster_compartment_details, autonomous_vm_cluster_id, **kwargs): """ - Moves an Autonomous Exadata VM cluster in the Oracle cloud and its dependent resources to another compartment. For Exadata Cloud@Customer systems, see :func:`change_autonomous_vm_cluster_compartment`. + Moves an Autonomous VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud@Customer only. For systems in the Oracle cloud, see :func:`change_autonomous_vm_cluster_compartment`. - :param oci.database.models.ChangeCloudAutonomousVmClusterCompartmentDetails change_cloud_autonomous_vm_cluster_compartment_details: (required) - Request to move cloud Autonomous VM cluster to a different compartment + :param oci.database.models.ChangeAutonomousVmClusterCompartmentDetails change_autonomous_vm_cluster_compartment_details: (required) + Request to move Autonomous VM cluster to a different compartment - :param str cloud_autonomous_vm_cluster_id: (required) - The Cloud VM cluster `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -1820,14 +1813,14 @@ def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_cloud_autonomous_vm_cluster_compartment API. + Click `here `__ to see an example of how to use change_autonomous_vm_cluster_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/changeCompartment" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/changeCompartment" method = "POST" - operation_name = "change_cloud_autonomous_vm_cluster_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ChangeCloudAutonomousVmClusterCompartment" + operation_name = "change_autonomous_vm_cluster_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ChangeAutonomousVmClusterCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1840,10 +1833,10 @@ def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_cloud_autonomous_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_autonomous_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1877,7 +1870,7 @@ def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous method=method, path_params=path_params, header_params=header_params, - body=change_cloud_autonomous_vm_cluster_compartment_details, + body=change_autonomous_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -1888,24 +1881,26 @@ def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous method=method, path_params=path_params, header_params=header_params, - body=change_cloud_autonomous_vm_cluster_compartment_details, + body=change_autonomous_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_infrastructure_compartment_details, cloud_exadata_infrastructure_id, **kwargs): + def change_backup_destination_compartment(self, change_compartment_details, backup_destination_id, **kwargs): """ - Moves a cloud Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.For more information about moving resources to a different compartment, see `Moving Database Resources to a Different Compartment`__. + Move the backup destination and its dependent resources to the specified compartment. + For more information, see + `Moving Database Resources to a Different Compartment`__. __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeCloudExadataInfrastructureCompartmentDetails change_cloud_exadata_infrastructure_compartment_details: (required) - Request to move cloud Exadata infrastructure resource to a different compartment. + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move backup destination to a different compartment. - :param str cloud_exadata_infrastructure_id: (required) - The cloud 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 @@ -1940,14 +1935,14 @@ def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_i :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_cloud_exadata_infrastructure_compartment API. + Click `here `__ to see an example of how to use change_backup_destination_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/actions/changeCompartment" + required_arguments = ['backupDestinationId'] + resource_path = "/backupDestinations/{backupDestinationId}/actions/changeCompartment" method = "POST" - operation_name = "change_cloud_exadata_infrastructure_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ChangeCloudExadataInfrastructureCompartment" + operation_name = "change_backup_destination_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/ChangeBackupDestinationCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -1960,10 +1955,10 @@ def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_i extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_cloud_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_backup_destination_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -1997,7 +1992,7 @@ def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_i method=method, path_params=path_params, header_params=header_params, - body=change_cloud_exadata_infrastructure_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2008,22 +2003,22 @@ def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_i method=method, path_params=path_params, header_params=header_params, - body=change_cloud_exadata_infrastructure_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_infrastructure_subscription_details, cloud_exadata_infrastructure_id, **kwargs): + def change_cloud_autonomous_vm_cluster_compartment(self, change_cloud_autonomous_vm_cluster_compartment_details, cloud_autonomous_vm_cluster_id, **kwargs): """ - Associate a cloud Exadata infrastructure with a different subscription. + Moves an Autonomous Exadata VM cluster in the Oracle cloud and its dependent resources to another compartment. For Exadata Cloud@Customer systems, see :func:`change_autonomous_vm_cluster_compartment`. - :param oci.database.models.ChangeCloudExadataInfrastructureSubscriptionDetails change_cloud_exadata_infrastructure_subscription_details: (required) - Associate a cloud Exadata infrastructure with a different subscription. + :param oci.database.models.ChangeCloudAutonomousVmClusterCompartmentDetails change_cloud_autonomous_vm_cluster_compartment_details: (required) + Request to move cloud Autonomous VM cluster to a different compartment - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + :param str cloud_autonomous_vm_cluster_id: (required) + The Cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2058,14 +2053,14 @@ def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_cloud_exadata_infrastructure_subscription API. + Click `here `__ to see an example of how to use change_cloud_autonomous_vm_cluster_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/actions/changeSubscription" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/changeCompartment" method = "POST" - operation_name = "change_cloud_exadata_infrastructure_subscription" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ChangeCloudExadataInfrastructureSubscription" + operation_name = "change_cloud_autonomous_vm_cluster_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ChangeCloudAutonomousVmClusterCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -2078,10 +2073,10 @@ def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_cloud_exadata_infrastructure_subscription got unknown kwargs: {extra_kwargs!r}") + f"change_cloud_autonomous_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -2115,7 +2110,7 @@ def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_ method=method, path_params=path_params, header_params=header_params, - body=change_cloud_exadata_infrastructure_subscription_details, + body=change_cloud_autonomous_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2126,22 +2121,24 @@ def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_ method=method, path_params=path_params, header_params=header_params, - body=change_cloud_exadata_infrastructure_subscription_details, + body=change_cloud_autonomous_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartment_details, cloud_vm_cluster_id, **kwargs): + def change_cloud_exadata_infrastructure_compartment(self, change_cloud_exadata_infrastructure_compartment_details, cloud_exadata_infrastructure_id, **kwargs): """ - Moves a cloud VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Moves a cloud Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only.For more information about moving resources to a different compartment, see `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeCloudVmClusterCompartmentDetails change_cloud_vm_cluster_compartment_details: (required) - Request to move cloud VM cluster to a different compartment - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param oci.database.models.ChangeCloudExadataInfrastructureCompartmentDetails change_cloud_exadata_infrastructure_compartment_details: (required) + Request to move cloud Exadata infrastructure resource to a different compartment. + + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -2176,14 +2173,14 @@ def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartmen :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_cloud_vm_cluster_compartment API. + Click `here `__ to see an example of how to use change_cloud_exadata_infrastructure_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/changeCompartment" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/actions/changeCompartment" method = "POST" - operation_name = "change_cloud_vm_cluster_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ChangeCloudVmClusterCompartment" + operation_name = "change_cloud_exadata_infrastructure_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ChangeCloudExadataInfrastructureCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -2196,10 +2193,10 @@ def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartmen extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_cloud_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_cloud_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_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} @@ -2233,7 +2230,7 @@ def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_cloud_vm_cluster_compartment_details, + body=change_cloud_exadata_infrastructure_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2244,22 +2241,22 @@ def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_cloud_vm_cluster_compartment_details, + body=change_cloud_exadata_infrastructure_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscription_details, cloud_vm_cluster_id, **kwargs): + def change_cloud_exadata_infrastructure_subscription(self, change_cloud_exadata_infrastructure_subscription_details, cloud_exadata_infrastructure_id, **kwargs): """ - Associate a cloud VM cluster with a different subscription. + Associate a cloud Exadata infrastructure with a different subscription. - :param oci.database.models.ChangeCloudVmClusterSubscriptionDetails change_cloud_vm_cluster_subscription_details: (required) - Associate a cloud VM cluster with a different subscription. + :param oci.database.models.ChangeCloudExadataInfrastructureSubscriptionDetails change_cloud_exadata_infrastructure_subscription_details: (required) + Associate a cloud Exadata infrastructure with a different subscription. - :param str cloud_vm_cluster_id: (required) - The cloud 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 @@ -2294,14 +2291,14 @@ def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscript :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_cloud_vm_cluster_subscription API. + Click `here `__ to see an example of how to use change_cloud_exadata_infrastructure_subscription API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/changeSubscription" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/actions/changeSubscription" method = "POST" - operation_name = "change_cloud_vm_cluster_subscription" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ChangeCloudVmClusterSubscription" + operation_name = "change_cloud_exadata_infrastructure_subscription" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ChangeCloudExadataInfrastructureSubscription" # Don't accept unknown kwargs expected_kwargs = [ @@ -2314,10 +2311,10 @@ def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscript extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_cloud_vm_cluster_subscription got unknown kwargs: {extra_kwargs!r}") + f"change_cloud_exadata_infrastructure_subscription got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_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} @@ -2351,7 +2348,7 @@ def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscript method=method, path_params=path_params, header_params=header_params, - body=change_cloud_vm_cluster_subscription_details, + body=change_cloud_exadata_infrastructure_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2362,26 +2359,22 @@ def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscript method=method, path_params=path_params, header_params=header_params, - body=change_cloud_vm_cluster_subscription_details, + body=change_cloud_exadata_infrastructure_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_database_software_image_compartment(self, change_compartment_details, database_software_image_id, **kwargs): + def change_cloud_vm_cluster_compartment(self, change_cloud_vm_cluster_compartment_details, cloud_vm_cluster_id, **kwargs): """ - Move the Database Software Image and its dependent resources to the specified compartment. - For more information about moving Databse Software Images, see - `Moving Database Resources to a Different Compartment`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes + Moves a cloud VM cluster and its dependent resources to another compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move Database Software Image to a different compartment + :param oci.database.models.ChangeCloudVmClusterCompartmentDetails change_cloud_vm_cluster_compartment_details: (required) + Request to move cloud VM cluster to a different compartment - :param str database_software_image_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 @@ -2416,14 +2409,14 @@ def change_database_software_image_compartment(self, change_compartment_details, :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_database_software_image_compartment API. + Click `here `__ to see an example of how to use change_cloud_vm_cluster_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseSoftwareImageId'] - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}/actions/changeCompartment" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/changeCompartment" method = "POST" - operation_name = "change_database_software_image_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/ChangeDatabaseSoftwareImageCompartment" + operation_name = "change_cloud_vm_cluster_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ChangeCloudVmClusterCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -2436,10 +2429,10 @@ def change_database_software_image_compartment(self, change_compartment_details, extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_database_software_image_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_cloud_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseSoftwareImageId": database_software_image_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -2473,131 +2466,7 @@ def change_database_software_image_compartment(self, change_compartment_details, method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) - else: - return self.base_client.call_api( - resource_path=resource_path, - method=method, - path_params=path_params, - header_params=header_params, - body=change_compartment_details, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) - - def change_dataguard_role(self, change_dataguard_role_details, autonomous_container_database_id, **kwargs): - """ - Switch the Autonomous Container Database role between Standby and Snapshot Standby. - For more information about changing Autonomous Container Databases Dataguard Role, see - `Convert Physical Standby to Snapshot Standby`__ and `Convert Snapshot Standby to Physical Standby`__. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/adbcl/index.html#ADBCL-GUID-D3B503F1-0032-4B0D-9F00-ACAE8151AB80 - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/adbcl/index.html#ADBCL-GUID-E8D7E0EE-8244-467D-B33A-1BC6F969A0A4 - - - :param oci.database.models.ChangeDataguardRoleDetails change_dataguard_role_details: (required) - Request to Change the Autonomous Container Database Dataguard role. - - :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 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. - - This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. - 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`. - - :param bool allow_control_chars: (optional) - allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. - By default, the response will not allow control characters in strings - - :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 change_dataguard_role API. - """ - # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeDataguardRole" - method = "POST" - operation_name = "change_dataguard_role" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ChangeDataguardRole" - - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"change_dataguard_role got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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} - - retry_strategy = self.base_client.get_preferred_retry_strategy( - operation_retry_strategy=kwargs.get('retry_strategy'), - client_retry_strategy=self.retry_strategy - ) - - if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) - self.base_client.add_opc_client_retries_header(header_params) - retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) - 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_dataguard_role_details, - response_type="AutonomousContainerDatabase", + body=change_cloud_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2608,34 +2477,22 @@ def change_dataguard_role(self, change_dataguard_role_details, autonomous_contai method=method, path_params=path_params, header_params=header_params, - body=change_dataguard_role_details, - response_type="AutonomousContainerDatabase", + body=change_cloud_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_db_system_compartment(self, change_compartment_details, db_system_id, **kwargs): + def change_cloud_vm_cluster_subscription(self, change_cloud_vm_cluster_subscription_details, cloud_vm_cluster_id, **kwargs): """ - Moves the DB system and its dependent resources to the specified compartment. - For more information about moving DB systems, see - `Moving Database Resources to a Different Compartment`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - - - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move the DB system to a different compartment. - - **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. + Associate a cloud VM cluster with a different subscription. - 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + :param oci.database.models.ChangeCloudVmClusterSubscriptionDetails change_cloud_vm_cluster_subscription_details: (required) + Associate a cloud VM cluster with a different subscription. - :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 @@ -2670,14 +2527,14 @@ def change_db_system_compartment(self, change_compartment_details, db_system_id, :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_db_system_compartment API. + Click `here `__ to see an example of how to use change_cloud_vm_cluster_subscription API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/actions/changeCompartment" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/changeSubscription" method = "POST" - operation_name = "change_db_system_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ChangeDbSystemCompartment" + operation_name = "change_cloud_vm_cluster_subscription" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ChangeCloudVmClusterSubscription" # Don't accept unknown kwargs expected_kwargs = [ @@ -2690,10 +2547,10 @@ def change_db_system_compartment(self, change_compartment_details, db_system_id, extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_db_system_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_cloud_vm_cluster_subscription got unknown kwargs: {extra_kwargs!r}") 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} @@ -2727,7 +2584,7 @@ def change_db_system_compartment(self, change_compartment_details, db_system_id, method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_cloud_vm_cluster_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2738,33 +2595,44 @@ def change_db_system_compartment(self, change_compartment_details, db_system_id, method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_cloud_vm_cluster_subscription_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_disaster_recovery_configuration(self, autonomous_database_id, change_disaster_recovery_configuration_details, **kwargs): + def change_database_software_image_compartment(self, change_compartment_details, database_software_image_id, **kwargs): """ - This operation updates the cross-region disaster recovery (DR) details of the standby Autonomous Database Serverless database, and must be run on the standby side. + Move the Database Software Image and its dependent resources to the specified compartment. + For more information about moving Databse Software Images, see + `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param str autonomous_database_id: (required) - The database `OCID`__. + + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move Database Software Image to a different compartment + + :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.ChangeDisasterRecoveryConfigurationDetails change_disaster_recovery_configuration_details: (required) - Request to update the cross-region disaster recovery (DR) details of the standby Autonomous Database Serverless 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 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. @@ -2777,33 +2645,34 @@ def change_disaster_recovery_configuration(self, autonomous_database_id, change_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 change_disaster_recovery_configuration API. + Click `here `__ to see an example of how to use change_database_software_image_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeDisasterRecoveryConfiguration" - method = "PUT" - operation_name = "change_disaster_recovery_configuration" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeDisasterRecoveryConfiguration" + required_arguments = ['databaseSoftwareImageId'] + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}/actions/changeCompartment" + method = "POST" + operation_name = "change_database_software_image_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/ChangeDatabaseSoftwareImageCompartment" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "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( - f"change_disaster_recovery_configuration got unknown kwargs: {extra_kwargs!r}") + f"change_database_software_image_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -2815,8 +2684,9 @@ def change_disaster_recovery_configuration(self, autonomous_database_id, change_ 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), + "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} @@ -2827,6 +2697,7 @@ def change_disaster_recovery_configuration(self, autonomous_database_id, change_ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -2835,8 +2706,7 @@ def change_disaster_recovery_configuration(self, autonomous_database_id, change_ method=method, path_params=path_params, header_params=header_params, - body=change_disaster_recovery_configuration_details, - response_type="AutonomousDatabase", + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2847,27 +2717,33 @@ def change_disaster_recovery_configuration(self, autonomous_database_id, change_ method=method, path_params=path_params, header_params=header_params, - body=change_disaster_recovery_configuration_details, - response_type="AutonomousDatabase", + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_exadata_infrastructure_compartment(self, change_exadata_infrastructure_compartment_details, exadata_infrastructure_id, **kwargs): + def change_dataguard_role(self, change_dataguard_role_details, autonomous_container_database_id, **kwargs): """ - Moves an Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. - To move an Exadata Cloud Service infrastructure resource to another compartment, use the :func:`change_cloud_exadata_infrastructure_compartment` operation. + Switch the Autonomous Container Database role between Standby and Snapshot Standby. + For more information about changing Autonomous Container Databases Dataguard Role, see + `Convert Physical Standby to Snapshot Standby`__ and `Convert Snapshot Standby to Physical Standby`__. + __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/adbcl/index.html#ADBCL-GUID-D3B503F1-0032-4B0D-9F00-ACAE8151AB80 + __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/adbcl/index.html#ADBCL-GUID-E8D7E0EE-8244-467D-B33A-1BC6F969A0A4 - :param oci.database.models.ChangeExadataInfrastructureCompartmentDetails change_exadata_infrastructure_compartment_details: (required) - Request to move Exadata infrastructure to a different compartment - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param oci.database.models.ChangeDataguardRoleDetails change_dataguard_role_details: (required) + Request to Change the Autonomous Container Database Dataguard role. + + :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 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 @@ -2875,9 +2751,6 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur 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 @@ -2895,34 +2768,34 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_exadata_infrastructure_compartment API. + Click `here `__ to see an example of how to use change_dataguard_role API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/changeCompartment" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/changeDataguardRole" method = "POST" - operation_name = "change_exadata_infrastructure_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/ChangeExadataInfrastructureCompartment" + operation_name = "change_dataguard_role" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ChangeDataguardRole" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", "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( - f"change_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_dataguard_role got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -2934,8 +2807,8 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur 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), "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} @@ -2956,7 +2829,8 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur method=method, path_params=path_params, header_params=header_params, - body=change_exadata_infrastructure_compartment_details, + body=change_dataguard_role_details, + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2967,22 +2841,34 @@ def change_exadata_infrastructure_compartment(self, change_exadata_infrastructur method=method, path_params=path_params, header_params=header_params, - body=change_exadata_infrastructure_compartment_details, + body=change_dataguard_role_details, + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartment_details, exadb_vm_cluster_id, **kwargs): + def change_db_system_compartment(self, change_compartment_details, db_system_id, **kwargs): """ - Moves a Exadata VM cluster on Exascale Infrastructure and its dependent resources to another compartment. Applies to Exadata Database Service on Exascale Infrastructure only. + Moves the DB system and its dependent resources to the specified compartment. + For more information about moving DB systems, see + `Moving Database Resources to a Different Compartment`__. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes - :param oci.database.models.ChangeExadbVmClusterCompartmentDetails change_exadb_vm_cluster_compartment_details: (required) - Request to move Exadata VM cluster on Exascale Infrastructure to a different compartment - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move the DB system to a different 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/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 @@ -3017,14 +2903,14 @@ def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartmen :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_exadb_vm_cluster_compartment API. + Click `here `__ to see an example of how to use change_db_system_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/actions/changeCompartment" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/actions/changeCompartment" method = "POST" - operation_name = "change_exadb_vm_cluster_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/ChangeExadbVmClusterCompartment" + operation_name = "change_db_system_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ChangeDbSystemCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3037,10 +2923,10 @@ def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartmen extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_exadb_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_db_system_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3074,7 +2960,7 @@ def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_exadb_vm_cluster_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3085,40 +2971,33 @@ def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartmen method=method, path_params=path_params, header_params=header_params, - body=change_exadb_vm_cluster_compartment_details, + body=change_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storage_vault_compartment_details, exascale_db_storage_vault_id, **kwargs): + def change_disaster_recovery_configuration(self, autonomous_database_id, change_disaster_recovery_configuration_details, **kwargs): """ - Moves a Exadata Database Storage Vault to another compartment. - + This operation updates the cross-region disaster recovery (DR) details of the standby Autonomous Database Serverless database, and must be run on the standby side. - :param oci.database.models.ChangeExascaleDbStorageVaultCompartmentDetails change_exascale_db_storage_vault_compartment_details: (required) - Request to move Exadata Database Storage Vault to a different compartment - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `OCID`__. + :param str autonomous_database_id: (required) + The 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 oci.database.models.ChangeDisasterRecoveryConfigurationDetails change_disaster_recovery_configuration_details: (required) + Request to update the cross-region disaster recovery (DR) details of the standby Autonomous Database Serverless 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. @@ -3131,34 +3010,33 @@ def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storag allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 change_exascale_db_storage_vault_compartment API. + Click `here `__ to see an example of how to use change_disaster_recovery_configuration API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exascaleDbStorageVaultId'] - resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}/actions/changeCompartment" - method = "POST" - operation_name = "change_exascale_db_storage_vault_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ChangeExascaleDbStorageVaultCompartment" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/changeDisasterRecoveryConfiguration" + method = "PUT" + operation_name = "change_disaster_recovery_configuration" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ChangeDisasterRecoveryConfiguration" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"change_exascale_db_storage_vault_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_disaster_recovery_configuration got unknown kwargs: {extra_kwargs!r}") path_params = { - "exascaleDbStorageVaultId": exascale_db_storage_vault_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3170,9 +3048,8 @@ def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storag 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) + "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} @@ -3183,7 +3060,6 @@ def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storag if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -3192,7 +3068,8 @@ def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storag method=method, path_params=path_params, header_params=header_params, - body=change_exascale_db_storage_vault_compartment_details, + body=change_disaster_recovery_configuration_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3203,27 +3080,24 @@ def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storag method=method, path_params=path_params, header_params=header_params, - body=change_exascale_db_storage_vault_compartment_details, + body=change_disaster_recovery_configuration_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_external_container_database_compartment(self, change_compartment_details, external_container_database_id, **kwargs): + def change_exadata_infrastructure_compartment(self, change_exadata_infrastructure_compartment_details, exadata_infrastructure_id, **kwargs): """ - 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 + Moves an Exadata infrastructure resource and its dependent resources to another compartment. Applies to Exadata Cloud@Customer instances only. + To move an Exadata Cloud Service infrastructure resource to another compartment, use the :func:`change_cloud_exadata_infrastructure_compartment` operation. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move the external container database to a different compartment. + :param oci.database.models.ChangeExadataInfrastructureCompartmentDetails change_exadata_infrastructure_compartment_details: (required) + Request to move Exadata infrastructure to a different compartment - :param str external_container_database_id: (required) - The ExternalContainerDatabase `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3258,14 +3132,14 @@ def change_external_container_database_compartment(self, change_compartment_deta :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_external_container_database_compartment API. + Click `here `__ to see an example of how to use change_exadata_infrastructure_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/changeCompartment" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/changeCompartment" method = "POST" - operation_name = "change_external_container_database_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ChangeExternalContainerDatabaseCompartment" + operation_name = "change_exadata_infrastructure_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/ChangeExadataInfrastructureCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3278,10 +3152,10 @@ def change_external_container_database_compartment(self, change_compartment_deta extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_external_container_database_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_exadata_infrastructure_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3315,7 +3189,7 @@ def change_external_container_database_compartment(self, change_compartment_deta method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exadata_infrastructure_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3326,26 +3200,22 @@ def change_external_container_database_compartment(self, change_compartment_deta method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exadata_infrastructure_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_external_non_container_database_compartment(self, change_compartment_details, external_non_container_database_id, **kwargs): + def change_exadb_vm_cluster_compartment(self, change_exadb_vm_cluster_compartment_details, exadb_vm_cluster_id, **kwargs): """ - 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 + Moves a Exadata VM cluster on Exascale Infrastructure and its dependent resources to another compartment. Applies to Exadata Database Service on Exascale Infrastructure only. - :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move the external non-container database to a different compartment. + :param oci.database.models.ChangeExadbVmClusterCompartmentDetails change_exadb_vm_cluster_compartment_details: (required) + Request to move Exadata VM cluster on Exascale Infrastructure to a different compartment - :param str external_non_container_database_id: (required) - The external non-container database `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3380,14 +3250,14 @@ def change_external_non_container_database_compartment(self, change_compartment_ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_external_non_container_database_compartment API. + Click `here `__ to see an example of how to use change_exadb_vm_cluster_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/changeCompartment" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/actions/changeCompartment" method = "POST" - operation_name = "change_external_non_container_database_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/ChangeExternalNonContainerDatabaseCompartment" + operation_name = "change_exadb_vm_cluster_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/ChangeExadbVmClusterCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3400,10 +3270,10 @@ def change_external_non_container_database_compartment(self, change_compartment_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_external_non_container_database_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_exadb_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3437,7 +3307,7 @@ def change_external_non_container_database_compartment(self, change_compartment_ method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exadb_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3448,29 +3318,22 @@ def change_external_non_container_database_compartment(self, change_compartment_ method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exadb_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_external_pluggable_database_compartment(self, change_compartment_details, external_pluggable_database_id, **kwargs): + def change_exascale_db_storage_vault_compartment(self, change_exascale_db_storage_vault_compartment_details, exascale_db_storage_vault_id, **kwargs): """ - 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`__. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes + Moves a Exadata Database Storage Vault to another compartment. - :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 oci.database.models.ChangeExascaleDbStorageVaultCompartmentDetails change_exascale_db_storage_vault_compartment_details: (required) + Request to move Exadata Database Storage Vault to a different compartment - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -3505,14 +3368,14 @@ def change_external_pluggable_database_compartment(self, change_compartment_deta :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_external_pluggable_database_compartment API. + Click `here `__ to see an example of how to use change_exascale_db_storage_vault_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/changeCompartment" + required_arguments = ['exascaleDbStorageVaultId'] + resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}/actions/changeCompartment" method = "POST" - operation_name = "change_external_pluggable_database_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/ChangeExternalPluggableDatabaseCompartment" + operation_name = "change_exascale_db_storage_vault_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ChangeExascaleDbStorageVaultCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3525,10 +3388,10 @@ def change_external_pluggable_database_compartment(self, change_compartment_deta extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_external_pluggable_database_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_exascale_db_storage_vault_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "exascaleDbStorageVaultId": exascale_db_storage_vault_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3562,7 +3425,7 @@ def change_external_pluggable_database_compartment(self, change_compartment_deta method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exascale_db_storage_vault_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3573,26 +3436,27 @@ def change_external_pluggable_database_compartment(self, change_compartment_deta method=method, path_params=path_params, header_params=header_params, - body=change_compartment_details, + body=change_exascale_db_storage_vault_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 @@ -3627,14 +3491,14 @@ 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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['keyStoreId'] - resource_path = "/keyStores/{keyStoreId}/actions/changeCompartment" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/changeCompartment" method = "POST" - operation_name = "change_key_store_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/ChangeKeyStoreCompartment" + operation_name = "change_external_container_database_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ChangeExternalContainerDatabaseCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3647,10 +3511,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( - f"change_key_store_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_external_container_database_compartment got unknown kwargs: {extra_kwargs!r}") 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} @@ -3684,7 +3548,7 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3695,140 +3559,26 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_key_store_type(self, database_id, change_key_store_type_details, **kwargs): - """ - Changes encryption key management type - - - :param str database_id: (required) - The database `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param oci.database.models.ChangeKeyStoreTypeDetails change_key_store_type_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. - - This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. - 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`. - - :param bool allow_control_chars: (optional) - allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. - By default, the response will not allow control characters in strings - - :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_key_store_type API. + def change_external_non_container_database_compartment(self, change_compartment_details, external_non_container_database_id, **kwargs): """ - # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/changeKeyStoreType" - method = "POST" - operation_name = "change_key_store_type" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ChangeKeyStoreType" - - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"change_key_store_type got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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} - - retry_strategy = self.base_client.get_preferred_retry_strategy( - operation_retry_strategy=kwargs.get('retry_strategy'), - client_retry_strategy=self.retry_strategy - ) - - if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) - self.base_client.add_opc_client_retries_header(header_params) - retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) - 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_key_store_type_details, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) - 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_type_details, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) + 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`__. - def change_oneoff_patch_compartment(self, change_compartment_details, oneoff_patch_id, **kwargs): - """ - Move the one-off patch to the specified compartment. + __ https://docs.cloud.oracle.com/Content/Database/Concepts/databaseoverview.htm#moveRes :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) - Request to move one-off patch to a different compartment + Request to move the external non-container database to a different compartment. - :param str oneoff_patch_id: (required) - The one-off patch `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 @@ -3863,14 +3613,14 @@ def change_oneoff_patch_compartment(self, change_compartment_details, oneoff_pat :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use change_oneoff_patch_compartment API. + Click `here `__ to see an example of how to use change_external_non_container_database_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['oneoffPatchId'] - resource_path = "/oneoffPatches/{oneoffPatchId}/actions/changeCompartment" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/changeCompartment" method = "POST" - operation_name = "change_oneoff_patch_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/ChangeOneoffPatchCompartment" + operation_name = "change_external_non_container_database_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/ChangeExternalNonContainerDatabaseCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -3883,10 +3633,10 @@ def change_oneoff_patch_compartment(self, change_compartment_details, oneoff_pat extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"change_oneoff_patch_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_external_non_container_database_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "oneoffPatchId": oneoff_patch_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -3937,17 +3687,23 @@ def change_oneoff_patch_compartment(self, change_compartment_details, oneoff_pat api_reference_link=api_reference_link, required_arguments=required_arguments) - def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, vm_cluster_id, **kwargs): + def change_external_pluggable_database_compartment(self, change_compartment_details, external_pluggable_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 :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`__. + __ 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 + :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 @@ -3982,14 +3738,14 @@ 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_pluggable_database_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/actions/changeCompartment" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/changeCompartment" method = "POST" - operation_name = "change_vm_cluster_compartment" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/ChangeVmClusterCompartment" + operation_name = "change_external_pluggable_database_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/ChangeExternalPluggableDatabaseCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -4002,10 +3758,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( - f"change_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") + f"change_external_pluggable_database_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4039,7 +3795,7 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4050,21 +3806,26 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def check_external_database_connector_connection_status(self, external_database_connector_id, **kwargs): + def change_key_store_compartment(self, change_key_store_compartment_details, key_store_id, **kwargs): """ - Check the status of the external database connection specified in this connector. - This operation will refresh the connectionStatus and timeConnectionStatusLastUpdated fields. + 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 str external_database_connector_id: (required) - The `OCID`__ of the - external database connector resource (`ExternalDatabaseConnectorId`). + + :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 @@ -4099,14 +3860,14 @@ def check_external_database_connector_connection_status(self, external_database_ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use check_external_database_connector_connection_status API. + Click `here `__ to see an example of how to use change_key_store_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalDatabaseConnectorId'] - resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}/actions/checkConnectionStatus" + required_arguments = ['keyStoreId'] + resource_path = "/keyStores/{keyStoreId}/actions/changeCompartment" method = "POST" - operation_name = "check_external_database_connector_connection_status" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/CheckExternalDatabaseConnectorConnectionStatus" + operation_name = "change_key_store_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/ChangeKeyStoreCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -4119,10 +3880,10 @@ def check_external_database_connector_connection_status(self, external_database_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"check_external_database_connector_connection_status got unknown kwargs: {extra_kwargs!r}") + f"change_key_store_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalDatabaseConnectorId": external_database_connector_id + "keyStoreId": key_store_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4156,6 +3917,7 @@ def check_external_database_connector_connection_status(self, external_database_ method=method, path_params=path_params, header_params=header_params, + body=change_key_store_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4166,27 +3928,24 @@ def check_external_database_connector_connection_status(self, external_database_ method=method, path_params=path_params, header_params=header_params, + body=change_key_store_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def complete_external_backup_job(self, backup_id, complete_external_backup_job_details, **kwargs): + def change_key_store_type(self, database_id, change_key_store_type_details, **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. - - **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 + Changes encryption key management type - :param str backup_id: (required) - The backup `OCID`__. + :param str database_id: (required) + The database `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 oci.database.models.ChangeKeyStoreTypeDetails change_key_store_type_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` @@ -4200,6 +3959,9 @@ 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 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. @@ -4212,33 +3974,34 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_key_store_type API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupId'] - resource_path = "/externalBackupJobs/{backupId}/actions/complete" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/changeKeyStoreType" method = "POST" - operation_name = "complete_external_backup_job" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/CompleteExternalBackupJob" + operation_name = "change_key_store_type" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ChangeKeyStoreType" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "if_match", - "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( - f"complete_external_backup_job got unknown kwargs: {extra_kwargs!r}") + f"change_key_store_type got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupId": backup_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4251,7 +4014,8 @@ def complete_external_backup_job(self, backup_id, complete_external_backup_job_d "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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -4271,8 +4035,7 @@ 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_key_store_type_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4283,29 +4046,142 @@ 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_key_store_type_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def configure_autonomous_database_vault_key(self, autonomous_database_id, configure_autonomous_database_vault_key_details, **kwargs): + def change_oneoff_patch_compartment(self, change_compartment_details, oneoff_patch_id, **kwargs): """ - Configures the Autonomous Database Vault service `key`__. + Move the one-off patch to the specified compartment. - __ https://docs.cloud.oracle.com/Content/KeyManagement/Concepts/keyoverview.htm#concepts + :param oci.database.models.ChangeCompartmentDetails change_compartment_details: (required) + Request to move one-off patch to a different compartment - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str oneoff_patch_id: (required) + The one-off patch `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ConfigureAutonomousDatabaseVaultKeyDetails configure_autonomous_database_vault_key_details: (required) - Configuration details for the Autonomous Database Vault service `key`__. + :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/KeyManagement/Concepts/keyoverview.htm#concepts + :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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_oneoff_patch_compartment API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['oneoffPatchId'] + resource_path = "/oneoffPatches/{oneoffPatchId}/actions/changeCompartment" + method = "POST" + operation_name = "change_oneoff_patch_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/ChangeOneoffPatchCompartment" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"change_oneoff_patch_compartment got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "oneoffPatchId": oneoff_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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) + } + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def change_scheduling_plan_compartment(self, change_scheduling_plan_compartment_details, scheduling_plan_id, **kwargs): + """ + Moves an scheduling plan resource to another compartment. + + + :param oci.database.models.ChangeSchedulingPlanCompartmentDetails change_scheduling_plan_compartment_details: (required) + Request to move scheduling plan to a different compartment + + :param str scheduling_plan_id: (required) + The Schedule Plan `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` @@ -4338,14 +4214,14 @@ def configure_autonomous_database_vault_key(self, autonomous_database_id, config :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use configure_autonomous_database_vault_key API. + Click `here `__ to see an example of how to use change_scheduling_plan_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/configureAutonomousDatabaseVaultKey" + required_arguments = ['schedulingPlanId'] + resource_path = "/schedulingPlans/{schedulingPlanId}/actions/changeCompartment" method = "POST" - operation_name = "configure_autonomous_database_vault_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ConfigureAutonomousDatabaseVaultKey" + operation_name = "change_scheduling_plan_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/ChangeSchedulingPlanCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -4358,10 +4234,10 @@ def configure_autonomous_database_vault_key(self, autonomous_database_id, config extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"configure_autonomous_database_vault_key got unknown kwargs: {extra_kwargs!r}") + f"change_scheduling_plan_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "schedulingPlanId": scheduling_plan_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4395,7 +4271,7 @@ def configure_autonomous_database_vault_key(self, autonomous_database_id, config method=method, path_params=path_params, header_params=header_params, - body=configure_autonomous_database_vault_key_details, + body=change_scheduling_plan_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4406,24 +4282,24 @@ def configure_autonomous_database_vault_key(self, autonomous_database_id, config method=method, path_params=path_params, header_params=header_params, - body=configure_autonomous_database_vault_key_details, + body=change_scheduling_plan_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin_user_details, **kwargs): + def change_scheduling_policy_compartment(self, change_scheduling_policy_compartment_details, scheduling_policy_id, **kwargs): """ - This operation updates SaaS administrative user configuration of the Autonomous Database. + Moves an scheduling policy resource to another compartment. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param oci.database.models.ChangeSchedulingPolicyCompartmentDetails change_scheduling_policy_compartment_details: (required) + Request to move scheduling policy to a different compartment - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. - :param oci.database.models.ConfigureSaasAdminUserDetails configure_saas_admin_user_details: (required) - Request to update SaaS administrative user configuration of the Autonomous 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` @@ -4433,6 +4309,13 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin :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. @@ -4445,33 +4328,34 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 configure_saas_admin_user API. + Click `here `__ to see an example of how to use change_scheduling_policy_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/configureSaasAdminUser" + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/actions/changeCompartment" method = "POST" - operation_name = "configure_saas_admin_user" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ConfigureSaasAdminUser" + operation_name = "change_scheduling_policy_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/ChangeSchedulingPolicyCompartment" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "if_match", - "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( - f"configure_saas_admin_user got unknown kwargs: {extra_kwargs!r}") + f"change_scheduling_policy_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "schedulingPolicyId": scheduling_policy_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4484,7 +4368,8 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin "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), + "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} @@ -4495,6 +4380,7 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -4503,8 +4389,7 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin method=method, path_params=path_params, header_params=header_params, - body=configure_saas_admin_user_details, - response_type="AutonomousDatabase", + body=change_scheduling_policy_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4515,21 +4400,23 @@ def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin method=method, path_params=path_params, header_params=header_params, - body=configure_saas_admin_user_details, - response_type="AutonomousDatabase", + body=change_scheduling_policy_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def confirm_key_store_details_are_correct(self, key_store_id, **kwargs): + def change_vm_cluster_compartment(self, change_vm_cluster_compartment_details, vm_cluster_id, **kwargs): """ - This is for user to confirm to DBaaS that the Oracle Key Valut (OKV) connection IPs, username and password are all correct. This operation will put - the Key Store back into Active state. If details are incorrect, your OKV account may get locked after some unsuccessful attempts to connect. + 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 str key_store_id: (required) - The `OCID`__ of the key store. + :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 @@ -4564,14 +4451,14 @@ def confirm_key_store_details_are_correct(self, key_store_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use confirm_key_store_details_are_correct API. + Click `here `__ to see an example of how to use change_vm_cluster_compartment API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['keyStoreId'] - resource_path = "/keyStores/{keyStoreId}/actions/confirmDetailsAreCorrect" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/actions/changeCompartment" method = "POST" - operation_name = "confirm_key_store_details_are_correct" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/ConfirmKeyStoreDetailsAreCorrect" + operation_name = "change_vm_cluster_compartment" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/ChangeVmClusterCompartment" # Don't accept unknown kwargs expected_kwargs = [ @@ -4584,10 +4471,10 @@ def confirm_key_store_details_are_correct(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( - f"confirm_key_store_details_are_correct got unknown kwargs: {extra_kwargs!r}") + f"change_vm_cluster_compartment got unknown kwargs: {extra_kwargs!r}") path_params = { - "keyStoreId": key_store_id + "vmClusterId": vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4621,6 +4508,7 @@ def confirm_key_store_details_are_correct(self, key_store_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=change_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4631,32 +4519,39 @@ def confirm_key_store_details_are_correct(self, key_store_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=change_vm_cluster_compartment_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): + def check_external_database_connector_connection_status(self, external_database_connector_id, **kwargs): """ - Converts a non-container database to a pluggable database. + Check the status of the external database connection specified in this connector. + This operation will refresh the connectionStatus and timeConnectionStatusLastUpdated fields. - :param str database_id: (required) - The database `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.ConvertToPdbDetails convert_to_pdb_details: (required) - Request to convert a non-container database to a pluggable 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 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. @@ -4669,33 +4564,34 @@ def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use convert_to_pdb API. + Click `here `__ to see an example of how to use check_external_database_connector_connection_status API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/convertToPdb" + required_arguments = ['externalDatabaseConnectorId'] + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}/actions/checkConnectionStatus" method = "POST" - operation_name = "convert_to_pdb" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ConvertToPdb" + operation_name = "check_external_database_connector_connection_status" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/CheckExternalDatabaseConnectorConnectionStatus" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "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( - f"convert_to_pdb got unknown kwargs: {extra_kwargs!r}") + f"check_external_database_connector_connection_status got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "externalDatabaseConnectorId": external_database_connector_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4707,8 +4603,9 @@ def convert_to_pdb(self, database_id, convert_to_pdb_details, **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) + "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} @@ -4719,6 +4616,7 @@ def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -4727,8 +4625,6 @@ def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=convert_to_pdb_details, - response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4739,35 +4635,33 @@ def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=convert_to_pdb_details, - response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_database_details, pluggable_database_id, **kwargs): + def complete_external_backup_job(self, backup_id, complete_external_backup_job_details, **kwargs): """ - Converts a Refreshable clone to Regular pluggable database (PDB). - Pluggable Database will be in `READ_WRITE` openmode after conversion. + 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.ConvertToRegularPluggableDatabaseDetails convert_to_regular_pluggable_database_details: (required) - Request to convert a Refreshable clone pluggable database (PDB) to a Regular pluggable database. + __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm - :param str pluggable_database_id: (required) - The database `OCID`__. + + :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_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 @@ -4787,34 +4681,33 @@ def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_dat allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 convert_to_regular_pluggable_database API. + Click `here `__ to see an example of how to use complete_external_backup_job API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/convertToRegular" + required_arguments = ['backupId'] + resource_path = "/externalBackupJobs/{backupId}/actions/complete" method = "POST" - operation_name = "convert_to_regular_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ConvertToRegularPluggableDatabase" + operation_name = "complete_external_backup_job" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/CompleteExternalBackupJob" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"convert_to_regular_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"complete_external_backup_job got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -4827,7 +4720,6 @@ def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_dat "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} @@ -4848,8 +4740,8 @@ def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_dat method=method, path_params=path_params, header_params=header_params, - body=convert_to_regular_pluggable_database_details, - response_type="PluggableDatabase", + body=complete_external_backup_job_details, + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4860,20 +4752,37 @@ def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_dat method=method, path_params=path_params, header_params=header_params, - body=convert_to_regular_pluggable_database_details, - response_type="PluggableDatabase", + body=complete_external_backup_job_details, + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_application_vip(self, create_application_vip_details, **kwargs): + def configure_autonomous_database_vault_key(self, autonomous_database_id, configure_autonomous_database_vault_key_details, **kwargs): """ - Creates a new application virtual IP (VIP) address in the specified cloud VM cluster based on the request parameters you provide. + Configures the Autonomous Database Vault service `key`__. + __ https://docs.cloud.oracle.com/Content/KeyManagement/Concepts/keyoverview.htm#concepts - :param oci.database.models.CreateApplicationVipDetails create_application_vip_details: (required) - Request to create a new application virtual IP (VIP) address. + + :param str autonomous_database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.ConfigureAutonomousDatabaseVaultKeyDetails configure_autonomous_database_vault_key_details: (required) + Configuration details for the Autonomous Database Vault service `key`__. + + __ https://docs.cloud.oracle.com/Content/KeyManagement/Concepts/keyoverview.htm#concepts + + :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 @@ -4882,9 +4791,6 @@ def create_application_vip(self, create_application_vip_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. @@ -4897,36 +4803,48 @@ def create_application_vip(self, create_application_vip_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ApplicationVip` + :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_application_vip API. + Click `here `__ to see an example of how to use configure_autonomous_database_vault_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/applicationVip" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/configureAutonomousDatabaseVaultKey" method = "POST" - operation_name = "create_application_vip" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/CreateApplicationVip" + operation_name = "configure_autonomous_database_vault_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ConfigureAutonomousDatabaseVaultKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "opc_request_id" + "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( - f"create_application_vip got unknown kwargs: {extra_kwargs!r}") + f"configure_autonomous_database_vault_key got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -4944,9 +4862,9 @@ def create_application_vip(self, create_application_vip_details, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_application_vip_details, - response_type="ApplicationVip", + body=configure_autonomous_database_vault_key_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -4955,28 +4873,34 @@ def create_application_vip(self, create_application_vip_details, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_application_vip_details, - response_type="ApplicationVip", + body=configure_autonomous_database_vault_key_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_container_database(self, create_autonomous_container_database_details, **kwargs): + def configure_saas_admin_user(self, autonomous_database_id, configure_saas_admin_user_details, **kwargs): """ - Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure. + This operation updates SaaS administrative user configuration of the Autonomous Database. - :param oci.database.models.CreateAutonomousContainerDatabaseDetails create_autonomous_container_database_details: (required) - Request to create an Autonomous Container Database in a specified Autonomous Exadata Infrastructure or in Autonomous VM Cluster. + :param str autonomous_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 oci.database.models.ConfigureSaasAdminUserDetails configure_saas_admin_user_details: (required) + Request to update SaaS administrative user configuration of the 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. @@ -4990,34 +4914,46 @@ def create_autonomous_container_database(self, create_autonomous_container_datab allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 create_autonomous_container_database API. + Click `here `__ to see an example of how to use configure_saas_admin_user API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousContainerDatabases" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/configureSaasAdminUser" method = "POST" - operation_name = "create_autonomous_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/CreateAutonomousContainerDatabase" + operation_name = "configure_saas_admin_user" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ConfigureSaasAdminUser" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "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( - f"create_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") + f"configure_saas_admin_user got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -5028,16 +4964,16 @@ def create_autonomous_container_database(self, create_autonomous_container_datab if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_autonomous_container_database_details, - response_type="AutonomousContainerDatabase", + body=configure_saas_admin_user_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5046,37 +4982,26 @@ def create_autonomous_container_database(self, create_autonomous_container_datab 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=configure_saas_admin_user_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, create_autonomous_container_database_dataguard_association_details, **kwargs): + def confirm_key_store_details_are_correct(self, key_store_id, **kwargs): """ - Create a new Autonomous Data Guard association. An Autonomous Data Guard association represents the replication relationship between the - specified Autonomous Container database and a peer Autonomous Container 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 + This is for user to confirm to DBaaS that the Oracle Key Valut (OKV) connection IPs, username and password are all correct. This operation will put + the Key Store back into Active state. If details are incorrect, your OKV account may get locked after some unsuccessful attempts to connect. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `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.CreateAutonomousContainerDatabaseDataguardAssociationDetails create_autonomous_container_database_dataguard_association_details: (required) - A request to create an Autonomous 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 server error without risk of executing that same action again. Retry tokens expire after 24 @@ -5084,6 +5009,14 @@ def create_autonomous_container_database_dataguard_association(self, autonomous_ 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. @@ -5096,32 +5029,34 @@ def create_autonomous_container_database_dataguard_association(self, autonomous_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 create_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use confirm_key_store_details_are_correct API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" + required_arguments = ['keyStoreId'] + resource_path = "/keyStores/{keyStoreId}/actions/confirmDetailsAreCorrect" method = "POST" - operation_name = "create_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/CreateAutonomousContainerDatabaseDataguardAssociation" + operation_name = "confirm_key_store_details_are_correct" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/ConfirmKeyStoreDetailsAreCorrect" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"confirm_key_store_details_are_correct got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "keyStoreId": key_store_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -5133,7 +5068,9 @@ def create_autonomous_container_database_dataguard_association(self, autonomous_ 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} @@ -5153,8 +5090,6 @@ def create_autonomous_container_database_dataguard_association(self, autonomous_ method=method, path_params=path_params, header_params=header_params, - body=create_autonomous_container_database_dataguard_association_details, - response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5165,27 +5100,28 @@ def create_autonomous_container_database_dataguard_association(self, autonomous_ method=method, path_params=path_params, header_params=header_params, - body=create_autonomous_container_database_dataguard_association_details, - response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_database(self, create_autonomous_database_details, **kwargs): + def convert_to_pdb(self, database_id, convert_to_pdb_details, **kwargs): """ - Creates a new Autonomous Database. + Converts a non-container database to a pluggable database. - :param oci.database.models.CreateAutonomousDatabaseBase create_autonomous_database_details: (required) - Request to create a new Autonomous Database. + :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 oci.database.models.ConvertToPdbDetails convert_to_pdb_details: (required) + Request to convert a non-container database to a pluggable 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. @@ -5202,35 +5138,45 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :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 convert_to_pdb API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabases" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/convertToPdb" method = "POST" - operation_name = "create_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/CreateAutonomousDatabase" + operation_name = "convert_to_pdb" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ConvertToPdb" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "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( - f"create_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"convert_to_pdb got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -5242,16 +5188,16 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_autonomous_database_details, - response_type="AutonomousDatabase", + body=convert_to_pdb_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5260,21 +5206,36 @@ def create_autonomous_database(self, create_autonomous_database_details, **kwarg 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=convert_to_pdb_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_database_backup(self, create_autonomous_database_backup_details, **kwargs): + def convert_to_regular_pluggable_database(self, convert_to_regular_pluggable_database_details, pluggable_database_id, **kwargs): """ - Creates a new Autonomous Database backup for the specified database based on the provided request parameters. + Converts a Refreshable clone to Regular pluggable database (PDB). + Pluggable Database will be in `READ_WRITE` openmode after conversion. - :param oci.database.models.CreateAutonomousDatabaseBackupDetails create_autonomous_database_backup_details: (required) - Request to create a new Autonomous Database backup. + :param oci.database.models.ConvertToRegularPluggableDatabaseDetails convert_to_regular_pluggable_database_details: (required) + Request to convert a Refreshable clone pluggable database (PDB) to a Regular pluggable database. + + :param str pluggable_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_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 @@ -5283,9 +5244,6 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de 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. @@ -5298,36 +5256,48 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.PluggableDatabase` :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 convert_to_regular_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabaseBackups" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/convertToRegular" method = "POST" - operation_name = "create_autonomous_database_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/CreateAutonomousDatabaseBackup" + operation_name = "convert_to_regular_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ConvertToRegularPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "opc_request_id" + "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( - f"create_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") + f"convert_to_regular_pluggable_database got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "pluggableDatabaseId": 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -5345,9 +5315,10 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup", + body=convert_to_regular_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5356,21 +5327,22 @@ def create_autonomous_database_backup(self, create_autonomous_database_backup_de return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup", + body=convert_to_regular_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_database_software_image(self, create_autonomous_database_software_image_details, **kwargs): + def create_application_vip(self, create_application_vip_details, **kwargs): """ - create Autonomous Database Software Image in the specified compartment. + Creates a new application virtual IP (VIP) address in the specified cloud VM cluster based on the request parameters you provide. - :param oci.database.models.CreateAutonomousDatabaseSoftwareImageDetails create_autonomous_database_software_image_details: (required) - Request to create Autonomous Database Software Image. + :param oci.database.models.CreateApplicationVipDetails create_application_vip_details: (required) + Request to create a new application virtual IP (VIP) address. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -5394,18 +5366,18 @@ def create_autonomous_database_software_image(self, create_autonomous_database_s allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseSoftwareImage` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ApplicationVip` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_autonomous_database_software_image API. + Click `here `__ to see an example of how to use create_application_vip API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/autonomousDatabaseSoftwareImages" + resource_path = "/applicationVip" method = "POST" - operation_name = "create_autonomous_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/CreateAutonomousDatabaseSoftwareImage" + operation_name = "create_application_vip" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/CreateApplicationVip" # Don't accept unknown kwargs expected_kwargs = [ @@ -5417,7 +5389,7 @@ def create_autonomous_database_software_image(self, create_autonomous_database_s extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"create_application_vip got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -5442,8 +5414,8 @@ def create_autonomous_database_software_image(self, create_autonomous_database_s resource_path=resource_path, method=method, header_params=header_params, - body=create_autonomous_database_software_image_details, - response_type="AutonomousDatabaseSoftwareImage", + body=create_application_vip_details, + response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5453,20 +5425,20 @@ def create_autonomous_database_software_image(self, create_autonomous_database_s resource_path=resource_path, method=method, header_params=header_params, - body=create_autonomous_database_software_image_details, - response_type="AutonomousDatabaseSoftwareImage", + body=create_application_vip_details, + response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **kwargs): + def create_autonomous_container_database(self, create_autonomous_container_database_details, **kwargs): """ - Creates an Autonomous VM cluster for Exadata Cloud@Customer. To create an Autonomous VM Cluster in the Oracle cloud, see :func:`create_cloud_autonomous_vm_cluster`. + Creates an Autonomous Container Database in the specified Autonomous Exadata Infrastructure. - :param oci.database.models.CreateAutonomousVmClusterDetails create_autonomous_vm_cluster_details: (required) - Request to create an Autonomous VM cluster. + :param oci.database.models.CreateAutonomousContainerDatabaseDetails create_autonomous_container_database_details: (required) + Request to create an Autonomous Container Database in a specified Autonomous Exadata Infrastructure or in 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 @@ -5475,9 +5447,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. @@ -5490,36 +5459,34 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabase` :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 create_autonomous_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/autonomousVmClusters" + resource_path = "/autonomousContainerDatabases" method = "POST" - operation_name = "create_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/CreateAutonomousVmCluster" + operation_name = "create_autonomous_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/CreateAutonomousContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -5538,8 +5505,8 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k resource_path=resource_path, method=method, header_params=header_params, - body=create_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster", + body=create_autonomous_container_database_details, + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5549,20 +5516,35 @@ def create_autonomous_vm_cluster(self, create_autonomous_vm_cluster_details, **k resource_path=resource_path, method=method, header_params=header_params, - body=create_autonomous_vm_cluster_details, - response_type="AutonomousVmCluster", + body=create_autonomous_container_database_details, + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_backup(self, create_backup_details, **kwargs): + def create_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, create_autonomous_container_database_dataguard_association_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. - + Create a new Autonomous Data Guard association. An Autonomous Data Guard association represents the replication relationship between the + specified Autonomous Container database and a peer Autonomous Container database. For more information, see `Using Oracle Data Guard`__. - :param oci.database.models.CreateBackupDetails create_backup_details: (required) - Request to create a new database backup. + 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 autonomous_container_database_id: (required) + The Autonomous Container Database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CreateAutonomousContainerDatabaseDataguardAssociationDetails create_autonomous_container_database_dataguard_association_details: (required) + A request to create an Autonomous 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 @@ -5583,18 +5565,18 @@ def create_backup(self, create_backup_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabaseDataguardAssociation` :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_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/backups" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" method = "POST" - operation_name = "create_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/CreateBackup" + operation_name = "create_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/CreateAutonomousContainerDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ @@ -5605,7 +5587,17 @@ 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( - f"create_backup got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { "accept": "application/json", @@ -5628,9 +5620,10 @@ def create_backup(self, create_backup_details, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_backup_details, - response_type="Backup", + body=create_autonomous_container_database_dataguard_association_details, + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5639,21 +5632,22 @@ def create_backup(self, create_backup_details, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_backup_details, - response_type="Backup", + body=create_autonomous_container_database_dataguard_association_details, + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 @@ -5677,18 +5671,18 @@ def create_backup_destination(self, create_backup_destination_details, **kwargs) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/backupDestinations" + resource_path = "/autonomousDatabases" method = "POST" - operation_name = "create_backup_destination" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/CreateBackupDestination" + operation_name = "create_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/CreateAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -5700,7 +5694,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( - f"create_backup_destination got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_database got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -5725,8 +5719,8 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5736,20 +5730,20 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_details, **kwargs): + def create_autonomous_database_backup(self, create_autonomous_database_backup_details, **kwargs): """ - Creates an Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`create_autonomous_vm_cluster`. + Creates a new Autonomous Database backup for the specified database based on the provided request parameters. - :param oci.database.models.CreateCloudAutonomousVmClusterDetails create_cloud_autonomous_vm_cluster_details: (required) - Request to create a cloud Autonomous VM cluster. + :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 @@ -5773,18 +5767,18 @@ def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudAutonomousVmCluster` + :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_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use create_autonomous_database_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/cloudAutonomousVmClusters" + resource_path = "/autonomousDatabaseBackups" method = "POST" - operation_name = "create_cloud_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/CreateCloudAutonomousVmCluster" + operation_name = "create_autonomous_database_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/CreateAutonomousDatabaseBackup" # Don't accept unknown kwargs expected_kwargs = [ @@ -5796,7 +5790,7 @@ def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -5821,8 +5815,8 @@ def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_ resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_autonomous_vm_cluster_details, - response_type="CloudAutonomousVmCluster", + body=create_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5832,24 +5826,20 @@ def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_ resource_path=resource_path, method=method, header_params=header_params, - body=create_cloud_autonomous_vm_cluster_details, - response_type="CloudAutonomousVmCluster", + body=create_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructure_details, **kwargs): + def create_autonomous_database_software_image(self, create_autonomous_database_software_image_details, **kwargs): """ - Creates a cloud Exadata infrastructure resource. This resource is used to create either an `Exadata Cloud Service`__ instance or an Autonomous Database on dedicated Exadata infrastructure. - - __ https://docs.cloud.oracle.com/Content/Database/Concepts/exaoverview.htm - + create Autonomous Database Software Image in the specified compartment. - :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.CreateAutonomousDatabaseSoftwareImageDetails create_autonomous_database_software_image_details: (required) + Request to create Autonomous 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 @@ -5873,18 +5863,18 @@ def create_cloud_exadata_infrastructure(self, create_cloud_exadata_infrastructur allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseSoftwareImage` :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_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/cloudExadataInfrastructures" + resource_path = "/autonomousDatabaseSoftwareImages" method = "POST" - operation_name = "create_cloud_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/CreateCloudExadataInfrastructure" + operation_name = "create_autonomous_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/CreateAutonomousDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ @@ -5896,7 +5886,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( - f"create_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -5921,8 +5911,8 @@ 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_software_image_details, + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -5932,22 +5922,20 @@ 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_software_image_details, + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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. To create an Autonomous VM Cluster in the Oracle cloud, see :func:`create_cloud_autonomous_vm_cluster`. - :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/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 @@ -5971,18 +5959,18 @@ def create_cloud_vm_cluster(self, create_cloud_vm_cluster_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/cloudVmClusters" + resource_path = "/autonomousVmClusters" method = "POST" - operation_name = "create_cloud_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/CreateCloudVmCluster" + operation_name = "create_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/CreateAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -5994,7 +5982,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( - f"create_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -6019,8 +6007,8 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6030,27 +6018,20 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 @@ -6071,18 +6052,18 @@ def create_console_connection(self, create_console_connection_details, db_node_i allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}/consoleConnections" + required_arguments = [] + resource_path = "/backups" method = "POST" - operation_name = "create_console_connection" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/CreateConsoleConnection" + operation_name = "create_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/CreateBackup" # Don't accept unknown kwargs expected_kwargs = [ @@ -6093,17 +6074,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( - f"create_console_connection got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_backup got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -6126,10 +6097,9 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6138,27 +6108,21 @@ def create_console_connection(self, create_console_connection_details, db_node_i 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_console_history(self, create_console_history_details, db_node_id, **kwargs): + def create_backup_destination(self, create_backup_destination_details, **kwargs): """ - Captures the most recent serial console data (up to a megabyte) for the specified database node. - - - :param oci.database.models.CreateConsoleHistoryDetails create_console_history_details: (required) - Request object for creating a console history. + Creates a backup destination in an Exadata Cloud@Customer system. - :param str db_node_id: (required) - The database node `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :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 @@ -6182,18 +6146,18 @@ def create_console_history(self, create_console_history_details, db_node_id, **k allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleHistory` + :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_console_history API. + Click `here `__ to see an example of how to use create_backup_destination API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories" + required_arguments = [] + resource_path = "/backupDestinations" method = "POST" - operation_name = "create_console_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/CreateConsoleHistory" + operation_name = "create_backup_destination" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/CreateBackupDestination" # Don't accept unknown kwargs expected_kwargs = [ @@ -6205,17 +6169,7 @@ def create_console_history(self, create_console_history_details, db_node_id, **k extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_console_history got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_backup_destination got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -6239,10 +6193,9 @@ def create_console_history(self, create_console_history_details, db_node_id, **k self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_console_history_details, - response_type="ConsoleHistory", + body=create_backup_destination_details, + response_type="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6251,37 +6204,21 @@ def create_console_history(self, create_console_history_details, db_node_id, **k return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, - body=create_console_history_details, - response_type="ConsoleHistory", + body=create_backup_destination_details, + response_type="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_data_guard_association(self, database_id, create_data_guard_association_details, **kwargs): + def create_cloud_autonomous_vm_cluster(self, create_cloud_autonomous_vm_cluster_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 an Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`create_autonomous_vm_cluster`. - __ 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.CreateCloudAutonomousVmClusterDetails create_cloud_autonomous_vm_cluster_details: (required) + Request to create a cloud 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 @@ -6290,6 +6227,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. @@ -6302,44 +6242,36 @@ def create_data_guard_association(self, database_id, create_data_guard_associati allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudAutonomousVmCluster` :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_cloud_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations" + required_arguments = [] + resource_path = "/cloudAutonomousVmClusters" method = "POST" - operation_name = "create_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/CreateDataGuardAssociation" + operation_name = "create_cloud_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/CreateCloudAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_data_guard_association got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") 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} @@ -6357,10 +6289,9 @@ 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_cloud_autonomous_vm_cluster_details, + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6369,22 +6300,25 @@ def create_data_guard_association(self, database_id, create_data_guard_associati 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_cloud_autonomous_vm_cluster_details, + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 either an `Exadata Cloud Service`__ instance or an Autonomous Database on dedicated Exadata infrastructure. + __ 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 @@ -6408,18 +6342,18 @@ def create_database(self, create_new_database_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/databases" + resource_path = "/cloudExadataInfrastructures" method = "POST" - operation_name = "create_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/CreateDatabase" + operation_name = "create_cloud_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/CreateCloudExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ @@ -6431,7 +6365,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( - f"create_database got unknown kwargs: {extra_kwargs!r}") + f"create_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -6456,8 +6390,8 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6467,20 +6401,22 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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/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 @@ -6489,6 +6425,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. @@ -6501,34 +6440,36 @@ def create_database_software_image(self, create_database_software_image_details, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/databaseSoftwareImages" + resource_path = "/cloudVmClusters" method = "POST" - operation_name = "create_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/CreateDatabaseSoftwareImage" + operation_name = "create_cloud_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/CreateCloudVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"create_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") 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} @@ -6547,8 +6488,8 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6558,20 +6499,27 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 @@ -6592,18 +6540,18 @@ def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/dbHomes" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}/consoleConnections" method = "POST" - operation_name = "create_db_home" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/CreateDbHome" + operation_name = "create_console_connection" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/CreateConsoleConnection" # Don't accept unknown kwargs expected_kwargs = [ @@ -6614,7 +6562,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( - f"create_db_home got unknown kwargs: {extra_kwargs!r}") + f"create_console_connection got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { "accept": "application/json", @@ -6637,9 +6595,10 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6648,22 +6607,27 @@ def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_exadata_infrastructure(self, create_exadata_infrastructure_details, **kwargs): + def create_console_history(self, create_console_history_details, db_node_id, **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. + Captures the most recent serial console data (up to a megabyte) for the specified database node. - :param oci.database.models.CreateExadataInfrastructureDetails create_exadata_infrastructure_details: (required) - Request to create Exadata Cloud@Customer infrastructure. + :param oci.database.models.CreateConsoleHistoryDetails create_console_history_details: (required) + Request object for creating a console history. + + :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 @@ -6687,18 +6651,18 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ConsoleHistory` :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_console_history API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/exadataInfrastructures" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories" method = "POST" - operation_name = "create_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/CreateExadataInfrastructure" + operation_name = "create_console_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/CreateConsoleHistory" # Don't accept unknown kwargs expected_kwargs = [ @@ -6710,7 +6674,17 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"create_console_history got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { "accept": "application/json", @@ -6734,9 +6708,10 @@ 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_console_history_details, + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6745,23 +6720,37 @@ def create_exadata_infrastructure(self, create_exadata_infrastructure_details, * 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_console_history_details, + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_exadb_vm_cluster(self, create_exadb_vm_cluster_details, **kwargs): + def create_data_guard_association(self, database_id, create_data_guard_association_details, **kwargs): """ - Creates an Exadata VM cluster on Exascale Infrastructure + 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`__. - :param oci.database.models.CreateExadbVmClusterDetails create_exadb_vm_cluster_details: (required) - Request to create a Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type. + __ https://docs.cloud.oracle.com/Content/Database/Tasks/usingdataguard.htm + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - __ https://docs.cloud.oracle.com/iaas/Content/Database/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + + :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 @@ -6770,9 +6759,6 @@ def create_exadb_vm_cluster(self, create_exadb_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. @@ -6785,36 +6771,44 @@ def create_exadb_vm_cluster(self, create_exadb_vm_cluster_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` + :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_exadb_vm_cluster API. + Click `here `__ to see an example of how to use create_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/exadbVmClusters" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations" method = "POST" - operation_name = "create_exadb_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/CreateExadbVmCluster" + operation_name = "create_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/CreateDataGuardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_data_guard_association got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -6832,9 +6826,10 @@ def create_exadb_vm_cluster(self, create_exadb_vm_cluster_details, **kwargs): self.base_client.call_api, resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + body=create_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6843,21 +6838,22 @@ def create_exadb_vm_cluster(self, create_exadb_vm_cluster_details, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - body=create_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + body=create_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_details, **kwargs): + def create_database(self, create_new_database_details, **kwargs): """ - Creates an Exadata Database Storage Vault + 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.CreateExascaleDbStorageVaultDetails create_exascale_db_storage_vault_details: (required) - Request to create a Exadata Database Storage Vault. + :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 @@ -6881,18 +6877,18 @@ def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_deta allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExascaleDbStorageVault` + :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_exascale_db_storage_vault API. + Click `here `__ to see an example of how to use create_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/exascaleDbStorageVaults" + resource_path = "/databases" method = "POST" - operation_name = "create_exascale_db_storage_vault" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/CreateExascaleDbStorageVault" + operation_name = "create_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/CreateDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -6904,7 +6900,7 @@ def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_deta extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") + f"create_database got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -6929,8 +6925,8 @@ def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_deta resource_path=resource_path, method=method, header_params=header_params, - body=create_exascale_db_storage_vault_details, - response_type="ExascaleDbStorageVault", + body=create_new_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -6940,24 +6936,20 @@ def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_deta resource_path=resource_path, method=method, header_params=header_params, - body=create_exascale_db_storage_vault_details, - response_type="ExascaleDbStorageVault", + body=create_new_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_external_backup_job(self, create_external_backup_job_details, **kwargs): + def create_database_software_image(self, create_database_software_image_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 + create database software image in the specified compartment. - :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.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 @@ -6978,18 +6970,18 @@ def create_external_backup_job(self, create_external_backup_job_details, **kwarg allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DatabaseSoftwareImage` :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_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/externalBackupJobs" + resource_path = "/databaseSoftwareImages" method = "POST" - operation_name = "create_external_backup_job" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/CreateExternalBackupJob" + operation_name = "create_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/CreateDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ @@ -7000,7 +6992,7 @@ def create_external_backup_job(self, create_external_backup_job_details, **kwarg extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_external_backup_job got unknown kwargs: {extra_kwargs!r}") + f"create_database_software_image got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7024,8 +7016,8 @@ 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_database_software_image_details, + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7035,20 +7027,20 @@ 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_database_software_image_details, + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_external_container_database(self, create_external_container_database_details, **kwargs): + def create_db_home(self, create_db_home_with_db_system_id_details, **kwargs): """ - Creates a new external container database resource. + 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.CreateExternalContainerDatabaseDetails create_external_container_database_details: (required) - Request to create a new external container database resource. + :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 @@ -7057,9 +7049,6 @@ def create_external_container_database(self, create_external_container_database_ 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. @@ -7072,36 +7061,34 @@ def create_external_container_database(self, create_external_container_database_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` + :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_external_container_database API. + Click `here `__ to see an example of how to use create_db_home API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/externalcontainerdatabases" + resource_path = "/dbHomes" method = "POST" - operation_name = "create_external_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/CreateExternalContainerDatabase" + operation_name = "create_db_home" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/CreateDbHome" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_external_container_database got unknown kwargs: {extra_kwargs!r}") + f"create_db_home got unknown kwargs: {extra_kwargs!r}") 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} @@ -7120,8 +7107,8 @@ def create_external_container_database(self, create_external_container_database_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_container_database_details, - response_type="ExternalContainerDatabase", + body=create_db_home_with_db_system_id_details, + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7131,20 +7118,21 @@ def create_external_container_database(self, create_external_container_database_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_container_database_details, - response_type="ExternalContainerDatabase", + body=create_db_home_with_db_system_id_details, + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_external_database_connector(self, create_external_database_connector_details, **kwargs): + def create_exadata_infrastructure(self, create_exadata_infrastructure_details, **kwargs): """ - Creates a new external database connector. + 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. - :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) - Request to create a connector to an external database. + :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 @@ -7168,18 +7156,18 @@ def create_external_database_connector(self, create_external_database_connector_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` + :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_external_database_connector API. + Click `here `__ to see an example of how to use create_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/externaldatabaseconnectors" + resource_path = "/exadataInfrastructures" method = "POST" - operation_name = "create_external_database_connector" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/CreateExternalDatabaseConnector" + operation_name = "create_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/CreateExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ @@ -7191,7 +7179,7 @@ def create_external_database_connector(self, create_external_database_connector_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_external_database_connector got unknown kwargs: {extra_kwargs!r}") + f"create_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7216,8 +7204,8 @@ def create_external_database_connector(self, create_external_database_connector_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_database_connector_details, - response_type="ExternalDatabaseConnector", + body=create_exadata_infrastructure_details, + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7227,20 +7215,22 @@ def create_external_database_connector(self, create_external_database_connector_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_database_connector_details, - response_type="ExternalDatabaseConnector", + body=create_exadata_infrastructure_details, + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_external_non_container_database(self, create_external_non_container_database_details, **kwargs): + def create_exadb_vm_cluster(self, create_exadb_vm_cluster_details, **kwargs): """ - Creates a new ExternalNonContainerDatabase resource + Creates an Exadata VM cluster on Exascale Infrastructure - :param oci.database.models.CreateExternalNonContainerDatabaseDetails create_external_non_container_database_details: (required) - Request to create a new external non-container database. + :param oci.database.models.CreateExadbVmClusterDetails create_exadb_vm_cluster_details: (required) + Request to create a Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. See `The New Exadata Cloud Service Resource Model`__ for information on this resource type. + + __ https://docs.cloud.oracle.com/iaas/Content/Database/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 @@ -7264,18 +7254,18 @@ def create_external_non_container_database(self, create_external_non_container_d allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_external_non_container_database API. + Click `here `__ to see an example of how to use create_exadb_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/externalnoncontainerdatabases" + resource_path = "/exadbVmClusters" method = "POST" - operation_name = "create_external_non_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/CreateExternalNonContainerDatabase" + operation_name = "create_exadb_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/CreateExadbVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -7287,7 +7277,7 @@ def create_external_non_container_database(self, create_external_non_container_d extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_external_non_container_database got unknown kwargs: {extra_kwargs!r}") + f"create_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7312,8 +7302,8 @@ def create_external_non_container_database(self, create_external_non_container_d resource_path=resource_path, method=method, header_params=header_params, - body=create_external_non_container_database_details, - response_type="ExternalNonContainerDatabase", + body=create_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7323,21 +7313,20 @@ def create_external_non_container_database(self, create_external_non_container_d resource_path=resource_path, method=method, header_params=header_params, - body=create_external_non_container_database_details, - response_type="ExternalNonContainerDatabase", + body=create_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_external_pluggable_database(self, create_external_pluggable_database_details, **kwargs): + def create_exascale_db_storage_vault(self, create_exascale_db_storage_vault_details, **kwargs): """ - Registers a new :func:`create_external_pluggable_database_details` - resource. + Creates an Exadata Database Storage Vault - :param oci.database.models.CreateExternalPluggableDatabaseDetails create_external_pluggable_database_details: (required) - Request to create a new external pluggable database. + :param oci.database.models.CreateExascaleDbStorageVaultDetails create_exascale_db_storage_vault_details: (required) + Request to create a Exadata Database Storage Vault. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -7361,18 +7350,18 @@ def create_external_pluggable_database(self, create_external_pluggable_database_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExascaleDbStorageVault` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_external_pluggable_database API. + Click `here `__ to see an example of how to use create_exascale_db_storage_vault API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/externalpluggabledatabases" + resource_path = "/exascaleDbStorageVaults" method = "POST" - operation_name = "create_external_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/CreateExternalPluggableDatabase" + operation_name = "create_exascale_db_storage_vault" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/CreateExascaleDbStorageVault" # Don't accept unknown kwargs expected_kwargs = [ @@ -7384,7 +7373,7 @@ def create_external_pluggable_database(self, create_external_pluggable_database_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"create_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7409,8 +7398,8 @@ def create_external_pluggable_database(self, create_external_pluggable_database_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_pluggable_database_details, - response_type="ExternalPluggableDatabase", + body=create_exascale_db_storage_vault_details, + response_type="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7420,20 +7409,20 @@ def create_external_pluggable_database(self, create_external_pluggable_database_ resource_path=resource_path, method=method, header_params=header_params, - body=create_external_pluggable_database_details, - response_type="ExternalPluggableDatabase", + body=create_exascale_db_storage_vault_details, + response_type="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_key_store(self, create_key_store_details, **kwargs): + def create_execution_action(self, create_execution_action_details, **kwargs): """ - Creates a Key Store. + Creates an execution action resource. - :param oci.database.models.CreateKeyStoreDetails create_key_store_details: (required) - Request to create a new key store. + :param oci.database.models.CreateExecutionActionDetails create_execution_action_details: (required) + Request to create execution action. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -7457,18 +7446,18 @@ def create_key_store(self, create_key_store_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionAction` :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_execution_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/keyStores" + resource_path = "/executionActions" method = "POST" - operation_name = "create_key_store" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/CreateKeyStore" + operation_name = "create_execution_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/CreateExecutionAction" # Don't accept unknown kwargs expected_kwargs = [ @@ -7480,7 +7469,7 @@ def create_key_store(self, create_key_store_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_key_store got unknown kwargs: {extra_kwargs!r}") + f"create_execution_action got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7505,8 +7494,8 @@ 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_execution_action_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7516,26 +7505,20 @@ 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_execution_action_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_maintenance_run(self, create_maintenance_run_details, **kwargs): + def create_execution_window(self, create_execution_window_details, **kwargs): """ - Creates a maintenance run with one of the following: - 1. The latest available release update patch (RUP) for the Autonomous Container Database. - 2. The latest available RUP and DST time-zone (TZ) file updates for the Autonomous Container Database. - 3. The DST TZ file updates for the Autonomous Container Database. + Creates an execution window resource. - :param oci.database.models.CreateMaintenanceRunDetails create_maintenance_run_details: (required) - Request to create a Maintenance Run for the resource. - - :param str opc_request_id: (optional) - Unique identifier for the request. + :param oci.database.models.CreateExecutionWindowDetails create_execution_window_details: (required) + Request to create execution window. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -7544,6 +7527,9 @@ def create_maintenance_run(self, create_maintenance_run_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. @@ -7556,36 +7542,36 @@ def create_maintenance_run(self, create_maintenance_run_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionWindow` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use create_maintenance_run API. + Click `here `__ to see an example of how to use create_execution_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/maintenanceRuns" + resource_path = "/executionWindows" method = "POST" - operation_name = "create_maintenance_run" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/CreateMaintenanceRun" + operation_name = "create_execution_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/CreateExecutionWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "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( - f"create_maintenance_run got unknown kwargs: {extra_kwargs!r}") + f"create_execution_window got unknown kwargs: {extra_kwargs!r}") 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-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} @@ -7604,8 +7590,8 @@ def create_maintenance_run(self, create_maintenance_run_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_maintenance_run_details, - response_type="MaintenanceRun", + body=create_execution_window_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7615,20 +7601,24 @@ def create_maintenance_run(self, create_maintenance_run_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_maintenance_run_details, - response_type="MaintenanceRun", + body=create_execution_window_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_oneoff_patch(self, create_oneoff_patch_details, **kwargs): + def create_external_backup_job(self, create_external_backup_job_details, **kwargs): """ - Creates one-off patch for specified database version to download. + 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 - :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) - Request to create a one-off patch to download. + + :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 @@ -7637,9 +7627,6 @@ def create_oneoff_patch(self, create_oneoff_patch_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. @@ -7652,36 +7639,34 @@ def create_oneoff_patch(self, create_oneoff_patch_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OneoffPatch` + :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_oneoff_patch API. + Click `here `__ to see an example of how to use create_external_backup_job API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/oneoffPatches" + resource_path = "/externalBackupJobs" method = "POST" - operation_name = "create_oneoff_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/CreateOneoffPatch" + operation_name = "create_external_backup_job" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/CreateExternalBackupJob" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"create_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + f"create_external_backup_job got unknown kwargs: {extra_kwargs!r}") 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} @@ -7700,8 +7685,8 @@ def create_oneoff_patch(self, create_oneoff_patch_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_oneoff_patch_details, - response_type="OneoffPatch", + body=create_external_backup_job_details, + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7711,22 +7696,20 @@ def create_oneoff_patch(self, create_oneoff_patch_details, **kwargs): resource_path=resource_path, method=method, header_params=header_params, - body=create_oneoff_patch_details, - response_type="OneoffPatch", + body=create_external_backup_job_details, + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_pluggable_database(self, create_pluggable_database_details, **kwargs): + def create_external_container_database(self, create_external_container_database_details, **kwargs): """ - Creates and starts a pluggable database in the specified container database. - Pluggable Database can be created using different operations (e.g. LocalClone, RemoteClone, Relocate ) with this API. - Use the :func:`start_pluggable_database` and :func:`stop_pluggable_database` APIs to start and stop the pluggable database. + Creates a new external container database resource. - :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) - Request to create pluggable database. + :param oci.database.models.CreateExternalContainerDatabaseDetails create_external_container_database_details: (required) + Request to create a new external container database 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 @@ -7750,18 +7733,18 @@ def create_pluggable_database(self, create_pluggable_database_details, **kwargs) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 create_pluggable_database API. + Click `here `__ to see an example of how to use create_external_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/pluggableDatabases" + resource_path = "/externalcontainerdatabases" method = "POST" - operation_name = "create_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/CreatePluggableDatabase" + operation_name = "create_external_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/CreateExternalContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -7773,7 +7756,7 @@ def create_pluggable_database(self, create_pluggable_database_details, **kwargs) extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"create_external_container_database got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7798,8 +7781,8 @@ def create_pluggable_database(self, create_pluggable_database_details, **kwargs) resource_path=resource_path, method=method, header_params=header_params, - body=create_pluggable_database_details, - response_type="PluggableDatabase", + body=create_external_container_database_details, + response_type="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7809,21 +7792,20 @@ def create_pluggable_database(self, create_pluggable_database_details, **kwargs) resource_path=resource_path, method=method, header_params=header_params, - body=create_pluggable_database_details, - response_type="PluggableDatabase", + body=create_external_container_database_details, + response_type="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_vm_cluster(self, create_vm_cluster_details, **kwargs): + def create_external_database_connector(self, create_external_database_connector_details, **kwargs): """ - Creates an Exadata Cloud@Customer VM cluster. + Creates a new external database connector. - :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 str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -7847,18 +7829,18 @@ def create_vm_cluster(self, create_vm_cluster_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalDatabaseConnector` :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_external_database_connector API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/vmClusters" + resource_path = "/externaldatabaseconnectors" method = "POST" - operation_name = "create_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/CreateVmCluster" + operation_name = "create_external_database_connector" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/CreateExternalDatabaseConnector" # Don't accept unknown kwargs expected_kwargs = [ @@ -7870,7 +7852,7 @@ def create_vm_cluster(self, create_vm_cluster_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"create_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_external_database_connector got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -7895,8 +7877,8 @@ 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_external_database_connector_details, + response_type="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -7906,26 +7888,20 @@ 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_external_database_connector_details, + response_type="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_details, **kwargs): + def create_external_non_container_database(self, create_external_non_container_database_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 a new ExternalNonContainerDatabase resource - __ 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 str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -7949,18 +7925,18 @@ def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalNonContainerDatabase` :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_external_non_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" + required_arguments = [] + resource_path = "/externalnoncontainerdatabases" method = "POST" - operation_name = "create_vm_cluster_network" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/CreateVmClusterNetwork" + operation_name = "create_external_non_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/CreateExternalNonContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -7972,17 +7948,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( - f"create_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_external_non_container_database got unknown kwargs: {extra_kwargs!r}") header_params = { "accept": "application/json", @@ -8006,10 +7972,9 @@ 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_external_non_container_database_details, + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8018,41 +7983,22 @@ def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ 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_external_non_container_database_details, + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def db_node_action(self, db_node_id, action, **kwargs): + def create_external_pluggable_database(self, create_external_pluggable_database_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. - - - :param str db_node_id: (required) - The database node `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + Registers a new :func:`create_external_pluggable_database_details` + resource. - :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 str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -8061,10 +8007,8 @@ 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 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. @@ -8078,51 +8022,36 @@ def db_node_action(self, db_node_id, action, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalPluggableDatabase` :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_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'action'] - resource_path = "/dbNodes/{dbNodeId}" + required_arguments = [] + resource_path = "/externalpluggabledatabases" method = "POST" - operation_name = "db_node_action" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/DbNodeAction" + operation_name = "create_external_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/CreateExternalPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "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( - f"db_node_action got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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} + f"create_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") 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-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} @@ -8140,10 +8069,9 @@ 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_pluggable_database_details, + response_type="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8152,29 +8080,28 @@ def db_node_action(self, db_node_id, action, **kwargs): 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_pluggable_database_details, + response_type="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_application_vip(self, application_vip_id, **kwargs): + def create_key_store(self, create_key_store_details, **kwargs): """ - Deletes and deregisters the specified application virtual IP (VIP) address. - + Creates a Key Store. - :param str application_vip_id: (required) - The `OCID`__ of the application virtual IP (VIP) address. - __ 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 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. @@ -8191,45 +8118,35 @@ def delete_application_vip(self, application_vip_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_application_vip API. + Click `here `__ to see an example of how to use create_key_store API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['applicationVipId'] - resource_path = "/applicationVip/{applicationVipId}" - method = "DELETE" - operation_name = "delete_application_vip" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/DeleteApplicationVip" + required_arguments = [] + resource_path = "/keyStores" + method = "POST" + operation_name = "create_key_store" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/CreateKeyStore" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_application_vip got unknown kwargs: {extra_kwargs!r}") - - path_params = { - "applicationVipId": application_vip_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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_key_store got unknown kwargs: {extra_kwargs!r}") 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} @@ -8241,14 +8158,16 @@ def delete_application_vip(self, application_vip_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_key_store_details, + response_type="KeyStore", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8257,31 +8176,35 @@ def delete_application_vip(self, application_vip_id, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_key_store_details, + response_type="KeyStore", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_autonomous_database(self, autonomous_database_id, **kwargs): + def create_maintenance_run(self, create_maintenance_run_details, **kwargs): """ - Deletes the specified Autonomous Database. - - - :param str autonomous_database_id: (required) - The database `OCID`__. + Creates a maintenance run with one of the following: + 1. The latest available release update patch (RUP) for the Autonomous Container Database. + 2. The latest available RUP and DST time-zone (TZ) file updates for the Autonomous Container Database. + 3. The DST TZ file updates for the Autonomous Container 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 oci.database.models.CreateMaintenanceRunDetails create_maintenance_run_details: (required) + Request to create a Maintenance Run for the resource. :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. @@ -8294,46 +8217,36 @@ def delete_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.MaintenanceRun` :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_maintenance_run API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" - method = "DELETE" - operation_name = "delete_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DeleteAutonomousDatabase" + required_arguments = [] + resource_path = "/maintenanceRuns" + method = "POST" + operation_name = "create_maintenance_run" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/CreateMaintenanceRun" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "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( - f"delete_autonomous_database got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_maintenance_run got unknown kwargs: {extra_kwargs!r}") 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), + "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} @@ -8344,14 +8257,16 @@ def delete_autonomous_database(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_maintenance_run_details, + response_type="MaintenanceRun", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8360,27 +8275,28 @@ def delete_autonomous_database(self, autonomous_database_id, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_maintenance_run_details, + response_type="MaintenanceRun", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): + def create_oneoff_patch(self, create_oneoff_patch_details, **kwargs): """ - Deletes a long-term backup. You cannot delete other backups using this API. - + Creates one-off patch for specified database version to download. - :param str autonomous_database_backup_id: (required) - The `OCID`__ of the Autonomous Database backup. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) + Request to create a one-off patch to download. - :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. @@ -8397,45 +8313,35 @@ def delete_autonomous_database_backup(self, autonomous_database_backup_id, **kwa allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.OneoffPatch` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_autonomous_database_backup API. + Click `here `__ to see an example of how to use create_oneoff_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseBackupId'] - resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" - method = "DELETE" - operation_name = "delete_autonomous_database_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/DeleteAutonomousDatabaseBackup" + required_arguments = [] + resource_path = "/oneoffPatches" + method = "POST" + operation_name = "create_oneoff_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/CreateOneoffPatch" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") - - path_params = { - "autonomousDatabaseBackupId": autonomous_database_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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_oneoff_patch got unknown kwargs: {extra_kwargs!r}") 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} @@ -8447,14 +8353,16 @@ def delete_autonomous_database_backup(self, autonomous_database_backup_id, **kwa if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_oneoff_patch_details, + response_type="OneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8463,27 +8371,30 @@ def delete_autonomous_database_backup(self, autonomous_database_backup_id, **kwa return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_oneoff_patch_details, + response_type="OneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_autonomous_database_software_image(self, autonomous_database_software_image_id, **kwargs): + def create_pluggable_database(self, create_pluggable_database_details, **kwargs): """ - Delete an Autonomous Database Software Image - + Creates and starts a pluggable database in the specified container database. + Pluggable Database can be created using different operations (e.g. LocalClone, RemoteClone, Relocate ) with this API. + Use the :func:`start_pluggable_database` and :func:`stop_pluggable_database` APIs to start and stop the pluggable database. - :param str autonomous_database_software_image_id: (required) - The Autonomous Database Software Image `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) + Request to create pluggable 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. @@ -8500,45 +8411,35 @@ def delete_autonomous_database_software_image(self, autonomous_database_software allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_autonomous_database_software_image API. + Click `here `__ to see an example of how to use create_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseSoftwareImageId'] - resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" - method = "DELETE" - operation_name = "delete_autonomous_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/DeleteAutonomousDatabaseSoftwareImage" + required_arguments = [] + resource_path = "/pluggableDatabases" + method = "POST" + operation_name = "create_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/CreatePluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") - - path_params = { - "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_pluggable_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -8550,14 +8451,16 @@ def delete_autonomous_database_software_image(self, autonomous_database_software if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8566,27 +8469,28 @@ def delete_autonomous_database_software_image(self, autonomous_database_software return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): + def create_scheduled_action(self, create_scheduled_action_details, **kwargs): """ - Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system. To delete an Autonomous VM Cluster in the Oracle cloud, see :func:`delete_cloud_autonomous_vm_cluster`. - + Creates a Scheduled Action resource. - :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.CreateScheduledActionDetails create_scheduled_action_details: (required) + Request to create Scheduled Action. - :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. @@ -8603,45 +8507,35 @@ def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ScheduledAction` :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_scheduled_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" - method = "DELETE" - operation_name = "delete_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/DeleteAutonomousVmCluster" + required_arguments = [] + resource_path = "/scheduledActions" + method = "POST" + operation_name = "create_scheduled_action" + api_reference_link = "" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_scheduled_action got unknown kwargs: {extra_kwargs!r}") 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} @@ -8653,14 +8547,16 @@ def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_scheduled_action_details, + response_type="ScheduledAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8669,27 +8565,31 @@ def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_scheduled_action_details, + response_type="ScheduledAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_backup(self, backup_id, **kwargs): + def create_scheduling_plan(self, create_scheduling_plan_details, **kwargs): """ - Deletes a full backup. You cannot delete automatic backups using this API. + Creates a Scheduling Plan resource. - :param str backup_id: (required) - The backup `OCID`__. + :param oci.database.models.CreateSchedulingPlanDetails create_scheduling_plan_details: (required) + Request to create Scheduling Plan. - __ 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. @@ -8703,44 +8603,36 @@ def delete_backup(self, backup_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SchedulingPlan` :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_scheduling_plan API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupId'] - resource_path = "/backups/{backupId}" - method = "DELETE" - operation_name = "delete_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/DeleteBackup" + required_arguments = [] + resource_path = "/schedulingPlans" + method = "POST" + operation_name = "create_scheduling_plan" + api_reference_link = "" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_backup got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_scheduling_plan got unknown kwargs: {extra_kwargs!r}") 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} @@ -8751,14 +8643,16 @@ def delete_backup(self, backup_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_scheduling_plan_details, + response_type="SchedulingPlan", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8767,27 +8661,28 @@ def delete_backup(self, backup_id, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_scheduling_plan_details, + response_type="SchedulingPlan", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_backup_destination(self, backup_destination_id, **kwargs): + def create_scheduling_policy(self, create_scheduling_policy_details, **kwargs): """ - Deletes a backup destination in an Exadata Cloud@Customer system. + Creates a Scheduling Policy resource. - :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.CreateSchedulingPolicyDetails create_scheduling_policy_details: (required) + Request to create Scheduling Policy. - :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. @@ -8804,45 +8699,35 @@ def delete_backup_destination(self, backup_destination_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SchedulingPolicy` :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_scheduling_policy API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupDestinationId'] - resource_path = "/backupDestinations/{backupDestinationId}" - method = "DELETE" - operation_name = "delete_backup_destination" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/DeleteBackupDestination" + required_arguments = [] + resource_path = "/schedulingPolicies" + method = "POST" + operation_name = "create_scheduling_policy" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/CreateSchedulingPolicy" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_backup_destination got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"create_scheduling_policy got unknown kwargs: {extra_kwargs!r}") 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} @@ -8854,14 +8739,16 @@ def delete_backup_destination(self, backup_destination_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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=create_scheduling_policy_details, + response_type="SchedulingPolicy", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8870,27 +8757,33 @@ def delete_backup_destination(self, backup_destination_id, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, header_params=header_params, + body=create_scheduling_policy_details, + response_type="SchedulingPolicy", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwargs): + def create_scheduling_window(self, scheduling_policy_id, create_scheduling_window_details, **kwargs): """ - Deletes the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`delete_autonomous_vm_cluster`. + Creates a Scheduling Window resource. - :param str cloud_autonomous_vm_cluster_id: (required) - The Cloud VM cluster `OCID`__. + :param str scheduling_policy_id: (required) + The Scheduling Policy `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.CreateSchedulingWindowDetails create_scheduling_window_details: (required) + Request to create Scheduling Window. + + :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. @@ -8907,33 +8800,33 @@ def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **k allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SchedulingWindow` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_cloud_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use create_scheduling_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" - method = "DELETE" - operation_name = "delete_cloud_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/DeleteCloudAutonomousVmCluster" + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/schedulingWindows" + method = "POST" + operation_name = "create_scheduling_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingWindow/CreateSchedulingWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_scheduling_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id + "schedulingPolicyId": scheduling_policy_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -8945,7 +8838,7 @@ def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **k 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} @@ -8957,6 +8850,7 @@ def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **k if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -8965,6 +8859,8 @@ def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **k method=method, path_params=path_params, header_params=header_params, + body=create_scheduling_window_details, + response_type="SchedulingWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -8975,28 +8871,28 @@ def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **k method=method, path_params=path_params, header_params=header_params, + body=create_scheduling_window_details, + response_type="SchedulingWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): + def create_vm_cluster(self, create_vm_cluster_details, **kwargs): """ - Deletes the cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - - - :param str cloud_exadata_infrastructure_id: (required) - The cloud Exadata infrastructure `OCID`__. + Creates an Exadata Cloud@Customer VM cluster. - __ 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.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 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. @@ -9013,51 +8909,35 @@ def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, * allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_exadata_infrastructure API. + Click `here `__ to see an example of how to use create_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" - method = "DELETE" - operation_name = "delete_cloud_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/DeleteCloudExadataInfrastructure" + required_arguments = [] + resource_path = "/vmClusters" + method = "POST" + operation_name = "create_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/CreateVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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} + f"create_vm_cluster got unknown kwargs: {extra_kwargs!r}") 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} @@ -9069,15 +8949,16 @@ def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, * if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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, + body=create_vm_cluster_details, + response_type="VmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -9086,28 +8967,34 @@ def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, * return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, - query_params=query_params, header_params=header_params, + body=create_vm_cluster_details, + response_type="VmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): + def create_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_details, **kwargs): """ - Deletes the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + 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 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 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.VmClusterNetworkDetails vm_cluster_network_details: (required) + Request to create the Cloud@Customer VM cluster network. + + :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. @@ -9124,33 +9011,33 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_cloud_vm_cluster API. + Click `here `__ to see an example of how to use create_vm_cluster_network API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}" - method = "DELETE" - operation_name = "delete_cloud_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/DeleteCloudVmCluster" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" + method = "POST" + operation_name = "create_vm_cluster_network" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/CreateVmClusterNetwork" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"create_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9162,7 +9049,7 @@ def delete_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} @@ -9174,6 +9061,7 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -9182,6 +9070,8 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=vm_cluster_network_details, + response_type="VmClusterNetwork", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -9192,14 +9082,28 @@ def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=vm_cluster_network_details, + response_type="VmClusterNetwork", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_console_connection(self, db_node_id, console_connection_id, **kwargs): + def db_node_action(self, db_node_id, action, **kwargs): """ - Deletes the specified database node console connection. + 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. :param str db_node_id: (required) @@ -9207,8 +9111,17 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_connection_id: (required) - The OCID of the console connection. + :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` @@ -9227,33 +9140,33 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_console_connection API. + Click `here `__ to see an example of how to use db_node_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleConnectionId'] - resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" - method = "DELETE" - operation_name = "delete_console_connection" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/DeleteConsoleConnection" + required_arguments = ['dbNodeId', 'action'] + resource_path = "/dbNodes/{dbNodeId}" + method = "POST" + operation_name = "db_node_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/DbNodeAction" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "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( - f"delete_console_connection got unknown kwargs: {extra_kwargs!r}") + f"db_node_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleConnectionId": console_connection_id + "dbNodeId": db_node_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9262,9 +9175,15 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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} + 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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -9276,6 +9195,7 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -9283,7 +9203,9 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -9293,25 +9215,24 @@ def delete_console_connection(self, db_node_id, console_connection_id, **kwargs) resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_console_history(self, db_node_id, console_history_id, **kwargs): + def delete_application_vip(self, application_vip_id, **kwargs): """ - Deletes the specified database node console history. + Deletes and deregisters the specified application virtual IP (VIP) address. - :param str db_node_id: (required) - The database node `OCID`__. + :param str application_vip_id: (required) + The `OCID`__ of the application virtual IP (VIP) address. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_history_id: (required) - The OCID of the console history. - :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 @@ -9336,14 +9257,14 @@ def delete_console_history(self, db_node_id, console_history_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_console_history API. + Click `here `__ to see an example of how to use delete_application_vip API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleHistoryId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" + required_arguments = ['applicationVipId'] + resource_path = "/applicationVip/{applicationVipId}" method = "DELETE" - operation_name = "delete_console_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/DeleteConsoleHistory" + operation_name = "delete_application_vip" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/DeleteApplicationVip" # Don't accept unknown kwargs expected_kwargs = [ @@ -9355,11 +9276,10 @@ def delete_console_history(self, db_node_id, console_history_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"delete_console_history got unknown kwargs: {extra_kwargs!r}") + f"delete_application_vip got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleHistoryId": console_history_id + "applicationVipId": application_vip_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9406,14 +9326,12 @@ def delete_console_history(self, db_node_id, console_history_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_database(self, database_id, **kwargs): + def delete_autonomous_database(self, autonomous_database_id, **kwargs): """ - 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. + Deletes 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 @@ -9423,13 +9341,6 @@ def delete_database(self, 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 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. @@ -9449,30 +9360,29 @@ def delete_database(self, database_id, **kwargs): :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 delete_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" method = "DELETE" - operation_name = "delete_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/DeleteDatabase" + operation_name = "delete_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DeleteAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_database got unknown kwargs: {extra_kwargs!r}") + f"delete_autonomous_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -9481,11 +9391,6 @@ def delete_database(self, database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - 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", @@ -9508,7 +9413,6 @@ def delete_database(self, database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -9519,20 +9423,19 @@ def delete_database(self, database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_database_software_image(self, database_software_image_id, **kwargs): + def delete_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): """ - Delete a database software image + Deletes a long-term backup. You cannot delete other backups using this API. - :param str database_software_image_id: (required) - The DB system `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 @@ -9541,6 +9444,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. @@ -9557,28 +9463,29 @@ 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_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseSoftwareImageId'] - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + required_arguments = ['autonomousDatabaseBackupId'] + resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" method = "DELETE" - operation_name = "delete_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/DeleteDatabaseSoftwareImage" + operation_name = "delete_autonomous_database_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/DeleteAutonomousDatabaseBackup" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"delete_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseSoftwareImageId": database_software_image_id + "autonomousDatabaseBackupId": autonomous_database_backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9590,7 +9497,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} @@ -9624,15 +9532,13 @@ def delete_database_software_image(self, database_software_image_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_db_home(self, db_home_id, **kwargs): + def delete_autonomous_database_software_image(self, autonomous_database_software_image_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. + Delete an Autonomous Database Software Image - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str autonomous_database_software_image_id: (required) + The Autonomous Database Software Image `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -9641,12 +9547,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. @@ -9664,29 +9566,29 @@ 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_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId'] - resource_path = "/dbHomes/{dbHomeId}" + required_arguments = ['autonomousDatabaseSoftwareImageId'] + resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" method = "DELETE" - operation_name = "delete_db_home" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/DeleteDbHome" + operation_name = "delete_autonomous_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/DeleteAutonomousDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_db_home got unknown kwargs: {extra_kwargs!r}") + f"delete_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id + "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9695,15 +9597,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(f'Parameter {k} cannot be None, whitespace or empty string') - 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} @@ -9721,7 +9619,6 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -9732,20 +9629,19 @@ 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, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): + def delete_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): """ - Deletes the Exadata Cloud@Customer infrastructure. + Deletes the specified Autonomous VM cluster in an Exadata Cloud@Customer system. To delete an Autonomous VM Cluster in the Oracle cloud, see :func:`delete_cloud_autonomous_vm_cluster`. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -9773,14 +9669,14 @@ 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_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "DELETE" - operation_name = "delete_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/DeleteExadataInfrastructure" + operation_name = "delete_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/DeleteAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -9792,10 +9688,10 @@ def delete_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( - f"delete_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"delete_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9842,13 +9738,13 @@ def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): + def delete_backup(self, backup_id, **kwargs): """ - Deletes the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. + Deletes a full backup. You cannot delete automatic backups using this API. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str backup_id: (required) + The backup `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -9857,9 +9753,6 @@ def delete_exadb_vm_cluster(self, exadb_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 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. @@ -9876,29 +9769,28 @@ def delete_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_exadb_vm_cluster API. + Click `here `__ to see an example of how to use delete_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}" + required_arguments = ['backupId'] + resource_path = "/backups/{backupId}" method = "DELETE" - operation_name = "delete_exadb_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/DeleteExadbVmCluster" + operation_name = "delete_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/DeleteBackup" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"delete_backup got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -9910,8 +9802,7 @@ def delete_exadb_vm_cluster(self, exadb_vm_cluster_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} @@ -9945,13 +9836,13 @@ def delete_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): + def delete_backup_destination(self, backup_destination_id, **kwargs): """ - Deletes the specified Exadata Database Storage Vault. + Deletes a backup destination in an Exadata Cloud@Customer system. - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `OCID`__. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -9979,14 +9870,14 @@ def delete_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwarg :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_exascale_db_storage_vault API. + Click `here `__ to see an example of how to use delete_backup_destination API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exascaleDbStorageVaultId'] - resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" + required_arguments = ['backupDestinationId'] + resource_path = "/backupDestinations/{backupDestinationId}" method = "DELETE" - operation_name = "delete_exascale_db_storage_vault" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/DeleteExascaleDbStorageVault" + operation_name = "delete_backup_destination" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/DeleteBackupDestination" # Don't accept unknown kwargs expected_kwargs = [ @@ -9998,10 +9889,10 @@ def delete_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwarg extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"delete_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") + f"delete_backup_destination got unknown kwargs: {extra_kwargs!r}") path_params = { - "exascaleDbStorageVaultId": exascale_db_storage_vault_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10048,26 +9939,24 @@ def delete_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwarg api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_external_container_database(self, external_container_database_id, **kwargs): + def delete_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - 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. + Deletes the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`delete_autonomous_vm_cluster`. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `OCID`__. + :param str cloud_autonomous_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 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. @@ -10084,29 +9973,29 @@ def delete_external_container_database(self, external_container_database_id, **k :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_external_container_database API. + Click `here `__ to see an example of how to use delete_cloud_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" method = "DELETE" - operation_name = "delete_external_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DeleteExternalContainerDatabase" + operation_name = "delete_cloud_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/DeleteCloudAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_external_container_database got unknown kwargs: {extra_kwargs!r}") + f"delete_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10118,8 +10007,8 @@ def delete_external_container_database(self, external_container_database_id, **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) + "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} @@ -10153,16 +10042,13 @@ def delete_external_container_database(self, external_container_database_id, **k api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_external_database_connector(self, external_database_connector_id, **kwargs): + def delete_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): """ - Deletes an external database connector. - Any services enabled using the external database connector must be - deleted prior to this operation. + Deletes the cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :param str external_database_connector_id: (required) - The `OCID`__ of the - external database connector resource (`ExternalDatabaseConnectorId`). + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10171,6 +10057,9 @@ def delete_external_database_connector(self, external_database_connector_id, **k 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. @@ -10190,29 +10079,30 @@ def delete_external_database_connector(self, external_database_connector_id, **k :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_external_database_connector API. + Click `here `__ to see an example of how to use delete_cloud_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalDatabaseConnectorId'] - resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "DELETE" - operation_name = "delete_external_database_connector" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/DeleteExternalDatabaseConnector" + operation_name = "delete_cloud_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/DeleteCloudExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_external_database_connector got unknown kwargs: {extra_kwargs!r}") + f"delete_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalDatabaseConnectorId": external_database_connector_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10221,6 +10111,11 @@ def delete_external_database_connector(self, external_database_connector_id, **k if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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", @@ -10243,6 +10138,7 @@ def delete_external_database_connector(self, external_database_connector_id, **k resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -10253,19 +10149,20 @@ def delete_external_database_connector(self, external_database_connector_id, **k resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_external_non_container_database(self, external_non_container_database_id, **kwargs): + def delete_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): """ - Deletes the Oracle Cloud Infrastructure resource representing an external non-container database. + Deletes the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :param str external_non_container_database_id: (required) - The external non-container database `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10293,14 +10190,14 @@ def delete_external_non_container_database(self, external_non_container_database :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_external_non_container_database API. + Click `here `__ to see an example of how to use delete_cloud_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "DELETE" - operation_name = "delete_external_non_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DeleteExternalNonContainerDatabase" + operation_name = "delete_cloud_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/DeleteCloudVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -10312,10 +10209,10 @@ def delete_external_non_container_database(self, external_non_container_database extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"delete_external_non_container_database got unknown kwargs: {extra_kwargs!r}") + f"delete_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10362,19 +10259,18 @@ def delete_external_non_container_database(self, external_non_container_database api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_external_pluggable_database(self, external_pluggable_database_id, **kwargs): + def delete_console_connection(self, db_node_id, console_connection_id, **kwargs): """ - Deletes the :func:`create_external_pluggable_database_details`. - resource. + Deletes the specified database node console connection. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `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 str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -10397,29 +10293,29 @@ def delete_external_pluggable_database(self, external_pluggable_database_id, **k :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_external_pluggable_database API. + Click `here `__ to see an example of how to use delete_console_connection API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + required_arguments = ['dbNodeId', 'consoleConnectionId'] + resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" method = "DELETE" - operation_name = "delete_external_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DeleteExternalPluggableDatabase" + operation_name = "delete_console_connection" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/DeleteConsoleConnection" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"delete_console_connection got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_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} @@ -10431,7 +10327,6 @@ def delete_external_pluggable_database(self, external_pluggable_database_id, **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} @@ -10466,16 +10361,19 @@ def delete_external_pluggable_database(self, external_pluggable_database_id, **k api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_key_store(self, key_store_id, **kwargs): + def delete_console_history(self, db_node_id, console_history_id, **kwargs): """ - Deletes a key store. + Deletes the specified database node console history. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str console_history_id: (required) + The OCID of the console history. + :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 @@ -10500,14 +10398,14 @@ 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_console_history API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['keyStoreId'] - resource_path = "/keyStores/{keyStoreId}" + required_arguments = ['dbNodeId', 'consoleHistoryId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" method = "DELETE" - operation_name = "delete_key_store" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/DeleteKeyStore" + operation_name = "delete_console_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/DeleteConsoleHistory" # Don't accept unknown kwargs expected_kwargs = [ @@ -10519,10 +10417,11 @@ 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( - f"delete_key_store got unknown kwargs: {extra_kwargs!r}") + f"delete_console_history got unknown kwargs: {extra_kwargs!r}") path_params = { - "keyStoreId": key_store_id + "dbNodeId": db_node_id, + "consoleHistoryId": console_history_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10569,19 +10468,136 @@ def delete_key_store(self, key_store_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_oneoff_patch(self, oneoff_patch_id, **kwargs): + def delete_database(self, database_id, **kwargs): """ - Deletes a one-off patch. + 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 oneoff_patch_id: (required) - The one-off patch `OCID`__. + + :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. + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_database API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}" + method = "DELETE" + operation_name = "delete_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/DeleteDatabase" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"delete_database got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def delete_database_software_image(self, database_software_image_id, **kwargs): + """ + Delete a database software image + + + :param str database_software_image_id: (required) + The DB system `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 @@ -10603,29 +10619,28 @@ def delete_oneoff_patch(self, oneoff_patch_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_oneoff_patch API. + Click `here `__ to see an example of how to use delete_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['oneoffPatchId'] - resource_path = "/oneoffPatches/{oneoffPatchId}" + required_arguments = ['databaseSoftwareImageId'] + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" method = "DELETE" - operation_name = "delete_oneoff_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/DeleteOneoffPatch" + operation_name = "delete_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/DeleteDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"delete_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + f"delete_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "oneoffPatchId": oneoff_patch_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10637,7 +10652,6 @@ def delete_oneoff_patch(self, oneoff_patch_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} @@ -10672,13 +10686,15 @@ def delete_oneoff_patch(self, oneoff_patch_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_pluggable_database(self, pluggable_database_id, **kwargs): + def delete_db_home(self, db_home_id, **kwargs): """ - Deletes the specified pluggable database. + 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 pluggable_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 @@ -10687,8 +10703,12 @@ def delete_pluggable_database(self, pluggable_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 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 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. @@ -10706,29 +10726,29 @@ def delete_pluggable_database(self, pluggable_database_id, **kwargs): :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use delete_pluggable_database API. + Click `here `__ to see an example of how to use delete_db_home API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}" + required_arguments = ['dbHomeId'] + resource_path = "/dbHomes/{dbHomeId}" method = "DELETE" - operation_name = "delete_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/DeletePluggableDatabase" + operation_name = "delete_db_home" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/DeleteDbHome" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "if_match", - "opc_request_id" + "perform_final_backup" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"delete_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"delete_db_home got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10737,11 +10757,15 @@ def delete_pluggable_database(self, pluggable_database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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) + "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} @@ -10759,6 +10783,7 @@ def delete_pluggable_database(self, pluggable_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -10769,19 +10794,20 @@ def delete_pluggable_database(self, pluggable_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_vm_cluster(self, vm_cluster_id, **kwargs): + def delete_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): """ - Deletes the specified VM cluster. Applies to Exadata Cloud@Customer instances only. + Deletes the Exadata Cloud@Customer infrastructure. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10809,14 +10835,14 @@ 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_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" method = "DELETE" - operation_name = "delete_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/DeleteVmCluster" + operation_name = "delete_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/DeleteExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ @@ -10828,10 +10854,10 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"delete_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"delete_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10878,19 +10904,13 @@ def delete_vm_cluster(self, vm_cluster_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def delete_exadb_vm_cluster(self, exadb_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 Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure 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 exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -10918,14 +10938,14 @@ 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_exadb_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}" method = "DELETE" - operation_name = "delete_vm_cluster_network" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DeleteVmClusterNetwork" + operation_name = "delete_exadb_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/DeleteExadbVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -10937,11 +10957,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( - f"delete_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") + f"delete_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -10988,22 +11007,24 @@ def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ api_reference_link=api_reference_link, required_arguments=required_arguments) - def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): + def delete_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): """ - Asynchronously deregisters this Autonomous Database with Data Safe. + Deletes the specified Exadata Database Storage Vault. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `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 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. @@ -11020,29 +11041,29 @@ 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_exascale_db_storage_vault API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/deregisterDataSafe" - method = "POST" - operation_name = "deregister_autonomous_database_data_safe" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DeregisterAutonomousDatabaseDataSafe" + required_arguments = ['exascaleDbStorageVaultId'] + resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" + method = "DELETE" + operation_name = "delete_exascale_db_storage_vault" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/DeleteExascaleDbStorageVault" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "deregister_autonomous_database_data_safe_details" + "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( - f"deregister_autonomous_database_data_safe got unknown kwargs: {extra_kwargs!r}") + f"delete_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "exascaleDbStorageVaultId": exascale_db_storage_vault_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11054,6 +11075,7 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa 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} @@ -11073,7 +11095,6 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('deregister_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -11084,22 +11105,26 @@ def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwa method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('deregister_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_autonomous_database_management(self, autonomous_database_id, **kwargs): + def delete_execution_action(self, execution_action_id, **kwargs): """ - Disables Database Management for the Autonomous Database resource. + Deletes the execution action. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str execution_action_id: (required) + The execution action `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. @@ -11119,28 +11144,29 @@ def disable_autonomous_database_management(self, autonomous_database_id, **kwarg :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_autonomous_database_management API. + Click `here `__ to see an example of how to use delete_execution_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableDatabaseManagement" - method = "POST" - operation_name = "disable_autonomous_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DisableAutonomousDatabaseManagement" + required_arguments = ['executionActionId'] + resource_path = "/executionActions/{executionActionId}" + method = "DELETE" + operation_name = "delete_execution_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/DeleteExecutionAction" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"disable_autonomous_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_execution_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "executionActionId": execution_action_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11152,6 +11178,7 @@ def disable_autonomous_database_management(self, autonomous_database_id, **kwarg 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} @@ -11186,16 +11213,21 @@ def disable_autonomous_database_management(self, autonomous_database_id, **kwarg api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): + def delete_execution_window(self, execution_window_id, **kwargs): """ - Disables Operations Insights for the Autonomous Database resource. + Deletes the execution window. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str execution_window_id: (required) + The execution window `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. @@ -11215,28 +11247,29 @@ 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_execution_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableOperationsInsights" - method = "POST" - operation_name = "disable_autonomous_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DisableAutonomousDatabaseOperationsInsights" + required_arguments = ['executionWindowId'] + resource_path = "/executionWindows/{executionWindowId}" + method = "DELETE" + operation_name = "delete_execution_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/DeleteExecutionWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"disable_autonomous_database_operations_insights got unknown kwargs: {extra_kwargs!r}") + f"delete_execution_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "executionWindowId": execution_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11248,6 +11281,7 @@ def disable_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} @@ -11282,23 +11316,18 @@ def disable_autonomous_database_operations_insights(self, autonomous_database_id api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_database_management(self, database_id, **kwargs): + def delete_external_container_database(self, external_container_database_id, **kwargs): """ - Disables the Database Management service for the database. + 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 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_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. @@ -11319,34 +11348,33 @@ def disable_database_management(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 None :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_database_management API. + Click `here `__ to see an example of how to use delete_external_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/disableDatabaseManagement" - method = "POST" - operation_name = "disable_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/DisableDatabaseManagement" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + method = "DELETE" + operation_name = "delete_external_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DeleteExternalContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"disable_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_external_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11358,7 +11386,6 @@ def disable_database_management(self, database_id, **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), "if-match": kwargs.get("if_match", missing) } @@ -11371,7 +11398,6 @@ def disable_database_management(self, database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11380,7 +11406,6 @@ def disable_database_management(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -11391,37 +11416,32 @@ def disable_database_management(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_container_database_database_management(self, external_container_database_id, **kwargs): + def delete_external_database_connector(self, external_database_connector_id, **kwargs): """ - Disable Database Management service for the external container database. + Deletes an external database connector. + Any services enabled using the external database connector must be + deleted prior to this operation. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `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 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 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. @@ -11438,30 +11458,29 @@ def disable_external_container_database_database_management(self, external_conta :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_container_database_database_management API. + Click `here `__ to see an example of how to use delete_external_database_connector API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/disableDatabaseManagement" - method = "POST" - operation_name = "disable_external_container_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DisableExternalContainerDatabaseDatabaseManagement" + required_arguments = ['externalDatabaseConnectorId'] + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + method = "DELETE" + operation_name = "delete_external_database_connector" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/DeleteExternalDatabaseConnector" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_container_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_external_database_connector got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "externalDatabaseConnectorId": external_database_connector_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11473,9 +11492,8 @@ def disable_external_container_database_database_management(self, external_conta 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) + "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} @@ -11486,7 +11504,6 @@ def disable_external_container_database_database_management(self, external_conta if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11510,31 +11527,24 @@ def disable_external_container_database_database_management(self, external_conta api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_container_database_stack_monitoring(self, external_container_database_id, **kwargs): + def delete_external_non_container_database(self, external_non_container_database_id, **kwargs): """ - Disable Stack Monitoring for the external container database. + Deletes the Oracle Cloud Infrastructure resource representing an external non-container database. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `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 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 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. @@ -11551,30 +11561,29 @@ def disable_external_container_database_stack_monitoring(self, external_containe :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_container_database_stack_monitoring API. + Click `here `__ to see an example of how to use delete_external_non_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/disableStackMonitoring" - method = "POST" - operation_name = "disable_external_container_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DisableExternalContainerDatabaseStackMonitoring" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + method = "DELETE" + operation_name = "delete_external_non_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DeleteExternalNonContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"delete_external_non_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11586,9 +11595,8 @@ def disable_external_container_database_stack_monitoring(self, external_containe 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) + "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} @@ -11599,7 +11607,6 @@ def disable_external_container_database_stack_monitoring(self, external_containe if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11623,27 +11630,17 @@ def disable_external_container_database_stack_monitoring(self, external_containe api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_non_container_database_database_management(self, external_non_container_database_id, **kwargs): + def delete_external_pluggable_database(self, external_pluggable_database_id, **kwargs): """ - 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 + Deletes the :func:`create_external_pluggable_database_details`. + resource. - :param str external_non_container_database_id: (required) - The external non-container 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. @@ -11668,30 +11665,29 @@ def disable_external_non_container_database_database_management(self, external_n :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_non_container_database_database_management API. + Click `here `__ to see an example of how to use delete_external_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableDatabaseManagement" - method = "POST" - operation_name = "disable_external_non_container_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseDatabaseManagement" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + method = "DELETE" + operation_name = "delete_external_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DeleteExternalPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"disable_external_non_container_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11703,7 +11699,6 @@ def disable_external_non_container_database_database_management(self, external_n 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) } @@ -11716,7 +11711,6 @@ def disable_external_non_container_database_database_management(self, external_n if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11740,31 +11734,24 @@ def disable_external_non_container_database_database_management(self, external_n api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_non_container_database_operations_insights(self, external_non_container_database_id, **kwargs): + def delete_key_store(self, key_store_id, **kwargs): """ - Disable Operations Insights for the external non-container database. + Deletes a key store. - :param str external_non_container_database_id: (required) - The external non-container database `OCID`__. + :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 - 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 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. @@ -11781,30 +11768,29 @@ def disable_external_non_container_database_operations_insights(self, external_n :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_non_container_database_operations_insights API. + Click `here `__ to see an example of how to use delete_key_store API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableOperationsInsights" - method = "POST" - operation_name = "disable_external_non_container_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseOperationsInsights" + required_arguments = ['keyStoreId'] + resource_path = "/keyStores/{keyStoreId}" + method = "DELETE" + operation_name = "delete_key_store" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/DeleteKeyStore" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_non_container_database_operations_insights got unknown kwargs: {extra_kwargs!r}") + f"delete_key_store got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "keyStoreId": key_store_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11816,9 +11802,8 @@ def disable_external_non_container_database_operations_insights(self, external_n 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) + "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} @@ -11829,7 +11814,6 @@ def disable_external_non_container_database_operations_insights(self, external_n if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11853,23 +11837,16 @@ def disable_external_non_container_database_operations_insights(self, external_n api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_non_container_database_stack_monitoring(self, external_non_container_database_id, **kwargs): + def delete_oneoff_patch(self, oneoff_patch_id, **kwargs): """ - Disable Stack Monitoring for the external non-container database. + Deletes a one-off patch. - :param str external_non_container_database_id: (required) - The external non-container database `OCID`__. + :param str oneoff_patch_id: (required) + The one-off patch `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. @@ -11894,30 +11871,29 @@ def disable_external_non_container_database_stack_monitoring(self, external_non_ :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_non_container_database_stack_monitoring API. + Click `here `__ to see an example of how to use delete_oneoff_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableStackMonitoring" - method = "POST" - operation_name = "disable_external_non_container_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseStackMonitoring" + required_arguments = ['oneoffPatchId'] + resource_path = "/oneoffPatches/{oneoffPatchId}" + method = "DELETE" + operation_name = "delete_oneoff_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/DeleteOneoffPatch" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"disable_external_non_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"delete_oneoff_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "oneoffPatchId": oneoff_patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -11929,7 +11905,6 @@ def disable_external_non_container_database_stack_monitoring(self, external_non_ 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) } @@ -11942,7 +11917,6 @@ def disable_external_non_container_database_stack_monitoring(self, external_non_ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -11966,35 +11940,24 @@ def disable_external_non_container_database_stack_monitoring(self, external_non_ api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_pluggable_database_database_management(self, external_pluggable_database_id, **kwargs): + def delete_pluggable_database(self, pluggable_database_id, **kwargs): """ - 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 + Deletes the specified pluggable database. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :param str pluggable_database_id: (required) + The 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 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. @@ -12011,30 +11974,29 @@ def disable_external_pluggable_database_database_management(self, external_plugg :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_pluggable_database_database_management API. + Click `here `__ to see an example of how to use delete_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableDatabaseManagement" - method = "POST" - operation_name = "disable_external_pluggable_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseDatabaseManagement" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}" + method = "DELETE" + operation_name = "delete_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/DeletePluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_pluggable_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12046,9 +12008,8 @@ def disable_external_pluggable_database_database_management(self, external_plugg 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) + "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} @@ -12059,7 +12020,6 @@ def disable_external_pluggable_database_database_management(self, external_plugg if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12083,31 +12043,24 @@ def disable_external_pluggable_database_database_management(self, external_plugg api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_pluggable_database_operations_insights(self, external_pluggable_database_id, **kwargs): + def delete_scheduled_action(self, scheduled_action_id, **kwargs): """ - Disable Operations Insights for the external pluggable database. + Deletes the scheduled action. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :param str scheduled_action_id: (required) + The Scheduled Action `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 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. @@ -12124,30 +12077,29 @@ def disable_external_pluggable_database_operations_insights(self, external_plugg :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_pluggable_database_operations_insights API. + Click `here `__ to see an example of how to use delete_scheduled_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableOperationsInsights" - method = "POST" - operation_name = "disable_external_pluggable_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseOperationsInsights" + required_arguments = ['scheduledActionId'] + resource_path = "/scheduledActions/{scheduledActionId}" + method = "DELETE" + operation_name = "delete_scheduled_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ScheduledAction/DeleteScheduledAction" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_pluggable_database_operations_insights got unknown kwargs: {extra_kwargs!r}") + f"delete_scheduled_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "scheduledActionId": scheduled_action_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12159,9 +12111,8 @@ def disable_external_pluggable_database_operations_insights(self, external_plugg 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) + "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} @@ -12172,7 +12123,6 @@ def disable_external_pluggable_database_operations_insights(self, external_plugg if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12196,31 +12146,127 @@ def disable_external_pluggable_database_operations_insights(self, external_plugg api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_external_pluggable_database_stack_monitoring(self, external_pluggable_database_id, **kwargs): + def delete_scheduling_plan(self, scheduling_plan_id, **kwargs): """ - Disable Stack Monitoring for the external pluggable database. + Deletes the scheduling plan. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :param str scheduling_plan_id: (required) + The Schedule Plan `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 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_scheduling_plan API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['schedulingPlanId'] + resource_path = "/schedulingPlans/{schedulingPlanId}" + method = "DELETE" + operation_name = "delete_scheduling_plan" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/DeleteSchedulingPlan" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"delete_scheduling_plan got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "schedulingPlanId": scheduling_plan_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def delete_scheduling_policy(self, scheduling_policy_id, **kwargs): + """ + Deletes the scheduling policy. + + + :param str scheduling_policy_id: (required) + The Scheduling Policy `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. @@ -12237,30 +12283,29 @@ def disable_external_pluggable_database_stack_monitoring(self, external_pluggabl :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use disable_external_pluggable_database_stack_monitoring API. + Click `here `__ to see an example of how to use delete_scheduling_policy API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableStackMonitoring" - method = "POST" - operation_name = "disable_external_pluggable_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseStackMonitoring" + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}" + method = "DELETE" + operation_name = "delete_scheduling_policy" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/DeleteSchedulingPolicy" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_external_pluggable_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"delete_scheduling_policy got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "schedulingPolicyId": scheduling_policy_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12272,9 +12317,8 @@ def disable_external_pluggable_database_stack_monitoring(self, external_pluggabl 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) + "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} @@ -12285,7 +12329,6 @@ def disable_external_pluggable_database_stack_monitoring(self, external_pluggabl if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12309,31 +12352,29 @@ def disable_external_pluggable_database_stack_monitoring(self, external_pluggabl api_reference_link=api_reference_link, required_arguments=required_arguments) - def disable_pluggable_database_management(self, pluggable_database_id, **kwargs): + def delete_scheduling_window(self, scheduling_policy_id, scheduling_window_id, **kwargs): """ - Disables the Database Management service for the pluggable database. + Deletes the scheduling window. - :param str pluggable_database_id: (required) - The database `OCID`__. + :param str scheduling_policy_id: (required) + The Scheduling Policy `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 scheduling_window_id: (required) + The Scheduling Window `OCID`__. - :param str opc_request_id: (optional) - Unique identifier for the request. + __ 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. @@ -12346,34 +12387,34 @@ def disable_pluggable_database_management(self, pluggable_database_id, **kwargs) allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 disable_pluggable_database_management API. + Click `here `__ to see an example of how to use delete_scheduling_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/disablePluggableDatabaseManagement" - method = "POST" - operation_name = "disable_pluggable_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/DisablePluggableDatabaseManagement" + required_arguments = ['schedulingPolicyId', 'schedulingWindowId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/schedulingWindows/{schedulingWindowId}" + method = "DELETE" + operation_name = "delete_scheduling_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingWindow/DeleteSchedulingWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"disable_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") + f"delete_scheduling_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "schedulingPolicyId": scheduling_policy_id, + "schedulingWindowId": scheduling_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12385,9 +12426,8 @@ def disable_pluggable_database_management(self, pluggable_database_id, **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), - "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} @@ -12398,7 +12438,6 @@ def disable_pluggable_database_management(self, pluggable_database_id, **kwargs) if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12407,7 +12446,6 @@ def disable_pluggable_database_management(self, pluggable_database_id, **kwargs) method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -12418,32 +12456,29 @@ def disable_pluggable_database_management(self, pluggable_database_id, **kwargs) method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, **kwargs): + def delete_vm_cluster(self, vm_cluster_id, **kwargs): """ - Downloads the configuration file for the specified Exadata Cloud@Customer infrastructure. + Deletes the specified VM cluster. Applies to Exadata Cloud@Customer instances only. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `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 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. @@ -12456,33 +12491,33 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/downloadConfigFile" - method = "POST" - operation_name = "download_exadata_infrastructure_config_file" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/DownloadExadataInfrastructureConfigFile" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}" + method = "DELETE" + operation_name = "delete_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/DeleteVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"download_exadata_infrastructure_config_file got unknown kwargs: {extra_kwargs!r}") + f"delete_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "vmClusterId": vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12492,10 +12527,10 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') 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), + "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} @@ -12506,7 +12541,6 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12515,7 +12549,6 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, method=method, path_params=path_params, header_params=header_params, - response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -12526,37 +12559,35 @@ def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, method=method, path_params=path_params, header_params=header_params, - response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def download_oneoff_patch(self, oneoff_patch_id, **kwargs): + def delete_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): """ - Download one-off patch. + 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 oneoff_patch_id: (required) - The one-off patch `OCID`__. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `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 vm_cluster_network_id: (required) + The VM cluster network `OCID`__. - :param str opc_request_id: (optional) - Unique identifier for the request. + __ 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. @@ -12569,34 +12600,34 @@ def download_oneoff_patch(self, oneoff_patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DownloadOneoffPatch` + :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_oneoff_patch API. + Click `here `__ to see an example of how to use delete_vm_cluster_network API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['oneoffPatchId'] - resource_path = "/oneoffPatches/{oneoffPatchId}/actions/downloadOneoffPatch" - method = "POST" - operation_name = "download_oneoff_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/DownloadOneoffPatch" + required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + method = "DELETE" + operation_name = "delete_vm_cluster_network" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DeleteVmClusterNetwork" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"download_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + f"delete_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") path_params = { - "oneoffPatchId": oneoff_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} @@ -12608,9 +12639,8 @@ def download_oneoff_patch(self, oneoff_patch_id, **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), - "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} @@ -12621,7 +12651,6 @@ def download_oneoff_patch(self, oneoff_patch_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12630,7 +12659,6 @@ def download_oneoff_patch(self, oneoff_patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DownloadOneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -12641,36 +12669,26 @@ def download_oneoff_patch(self, oneoff_patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DownloadOneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def download_validation_report(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def deregister_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): """ - Downloads the network validation report file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - - - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + Asynchronously deregisters this Autonomous Database with Data Safe. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `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 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. @@ -12684,34 +12702,33 @@ def download_validation_report(self, exadata_infrastructure_id, vm_cluster_netwo allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_validation_report API. + Click `here `__ to see an example of how to use deregister_autonomous_database_data_safe API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadValidationReport" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/deregisterDataSafe" method = "POST" - operation_name = "download_validation_report" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DownloadValidationReport" + operation_name = "deregister_autonomous_database_data_safe" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DeregisterAutonomousDatabaseDataSafe" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "opc_request_id", - "opc_retry_token" + "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( - f"download_validation_report got unknown kwargs: {extra_kwargs!r}") + f"deregister_autonomous_database_data_safe got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12721,10 +12738,9 @@ def download_validation_report(self, exadata_infrastructure_id, vm_cluster_netwo raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') 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) + "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} @@ -12735,7 +12751,6 @@ def download_validation_report(self, exadata_infrastructure_id, vm_cluster_netwo if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12744,7 +12759,7 @@ def download_validation_report(self, exadata_infrastructure_id, vm_cluster_netwo method=method, path_params=path_params, header_params=header_params, - response_type="stream", + body=kwargs.get('deregister_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -12755,37 +12770,25 @@ def download_validation_report(self, exadata_infrastructure_id, vm_cluster_netwo method=method, path_params=path_params, header_params=header_params, - response_type="stream", + body=kwargs.get('deregister_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def disable_autonomous_database_management(self, autonomous_database_id, **kwargs): """ - Downloads the configuration file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - - - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + Disables Database Management for the Autonomous Database resource. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `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 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. @@ -12798,34 +12801,32 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 disable_autonomous_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadConfigFile" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableDatabaseManagement" method = "POST" - operation_name = "download_vm_cluster_network_config_file" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DownloadVmClusterNetworkConfigFile" + operation_name = "disable_autonomous_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DisableAutonomousDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "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( - f"download_vm_cluster_network_config_file got unknown kwargs: {extra_kwargs!r}") + f"disable_autonomous_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -12835,10 +12836,9 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') 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) + "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} @@ -12849,7 +12849,6 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -12858,7 +12857,6 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ method=method, path_params=path_params, header_params=header_params, - response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -12869,15 +12867,14 @@ def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_ method=method, path_params=path_params, header_params=header_params, - response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_autonomous_database_management(self, autonomous_database_id, **kwargs): + def disable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): """ - Enables Database Management for Autonomous Database. + Disables Operations Insights for the Autonomous Database resource. :param str autonomous_database_id: (required) @@ -12904,14 +12901,14 @@ def enable_autonomous_database_management(self, autonomous_database_id, **kwargs :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_autonomous_database_management API. + Click `here `__ to see an example of how to use disable_autonomous_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableDatabaseManagement" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableOperationsInsights" method = "POST" - operation_name = "enable_autonomous_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/EnableAutonomousDatabaseManagement" + operation_name = "disable_autonomous_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/DisableAutonomousDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ @@ -12922,7 +12919,7 @@ def enable_autonomous_database_management(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( - f"enable_autonomous_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_autonomous_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { "autonomousDatabaseId": autonomous_database_id @@ -12971,105 +12968,9 @@ def enable_autonomous_database_management(self, autonomous_database_id, **kwargs api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): - """ - Enables the specified Autonomous Database with Operations Insights. - - - :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. - - This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. - 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`. - - :param bool allow_control_chars: (optional) - allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. - By default, the response will not allow control characters in strings - - :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 enable_autonomous_database_operations_insights API. - """ - # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableOperationsInsights" - method = "POST" - operation_name = "enable_autonomous_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/EnableAutonomousDatabaseOperationsInsights" - - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"enable_autonomous_database_operations_insights got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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.base_client.get_preferred_retry_strategy( - operation_retry_strategy=kwargs.get('retry_strategy'), - client_retry_strategy=self.retry_strategy - ) - - if retry_strategy: - if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_client_retries_header(header_params) - retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) - 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, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) - else: - return self.base_client.call_api( - resource_path=resource_path, - method=method, - path_params=path_params, - header_params=header_params, - allow_control_chars=kwargs.get('allow_control_chars'), - operation_name=operation_name, - api_reference_link=api_reference_link, - required_arguments=required_arguments) - - def enable_database_management(self, database_id, enable_database_management_details, **kwargs): + def disable_database_management(self, database_id, **kwargs): """ - Enables the Database Management service for an Oracle Database located in Oracle Cloud Infrastructure. This service allows the database to access tools including Metrics and Performance hub. Database Management is enabled at the container database (CDB) level. + Disables the Database Management service for the database. :param str database_id: (required) @@ -13077,9 +12978,6 @@ def enable_database_management(self, database_id, enable_database_management_det __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableDatabaseManagementDetails enable_database_management_details: (required) - Request to enable the Database Management service for an Oracle Database located in Oracle Cloud 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 server error without risk of executing that same action again. Retry tokens expire after 24 @@ -13111,14 +13009,14 @@ def enable_database_management(self, database_id, enable_database_management_det :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_database_management API. + Click `here `__ to see an example of how to use disable_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/enableDatabaseManagement" + resource_path = "/databases/{databaseId}/actions/disableDatabaseManagement" method = "POST" - operation_name = "enable_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/EnableDatabaseManagement" + operation_name = "disable_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/DisableDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ @@ -13131,7 +13029,7 @@ def enable_database_management(self, database_id, enable_database_management_det extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { "databaseId": database_id @@ -13168,7 +13066,6 @@ def enable_database_management(self, database_id, enable_database_management_det method=method, path_params=path_params, header_params=header_params, - body=enable_database_management_details, response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -13180,20 +13077,15 @@ def enable_database_management(self, database_id, enable_database_management_det method=method, path_params=path_params, header_params=header_params, - body=enable_database_management_details, response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_container_database_database_management(self, external_container_database_id, enable_external_container_database_database_management_details, **kwargs): + def disable_external_container_database_database_management(self, external_container_database_id, **kwargs): """ - 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 + Disable Database Management service for the external container database. :param str external_container_database_id: (required) @@ -13201,9 +13093,6 @@ def enable_external_container_database_database_management(self, external_contai __ 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 @@ -13235,14 +13124,14 @@ def enable_external_container_database_database_management(self, external_contai :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_container_database_database_management API. + Click `here `__ to see an example of how to use disable_external_container_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/enableDatabaseManagement" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/disableDatabaseManagement" method = "POST" - operation_name = "enable_external_container_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/EnableExternalContainerDatabaseDatabaseManagement" + operation_name = "disable_external_container_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DisableExternalContainerDatabaseDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ @@ -13255,7 +13144,7 @@ def enable_external_container_database_database_management(self, external_contai extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_container_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_external_container_database_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { "externalContainerDatabaseId": external_container_database_id @@ -13292,7 +13181,6 @@ def enable_external_container_database_database_management(self, external_contai method=method, path_params=path_params, header_params=header_params, - body=enable_external_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13303,15 +13191,14 @@ def enable_external_container_database_database_management(self, external_contai method=method, path_params=path_params, header_params=header_params, - body=enable_external_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_container_database_stack_monitoring(self, external_container_database_id, enable_external_container_database_stack_monitoring_details, **kwargs): + def disable_external_container_database_stack_monitoring(self, external_container_database_id, **kwargs): """ - Enable Stack Monitoring for the external container database. + Disable Stack Monitoring for the external container database. :param str external_container_database_id: (required) @@ -13319,9 +13206,6 @@ def enable_external_container_database_stack_monitoring(self, external_container __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableExternalContainerDatabaseStackMonitoringDetails enable_external_container_database_stack_monitoring_details: (required) - Details to enable Stack Monitoring on the 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 @@ -13353,14 +13237,14 @@ def enable_external_container_database_stack_monitoring(self, external_container :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_container_database_stack_monitoring API. + Click `here `__ to see an example of how to use disable_external_container_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/enableStackMonitoring" + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/disableStackMonitoring" method = "POST" - operation_name = "enable_external_container_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/EnableExternalContainerDatabaseStackMonitoring" + operation_name = "disable_external_container_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/DisableExternalContainerDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ @@ -13373,7 +13257,7 @@ def enable_external_container_database_stack_monitoring(self, external_container extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"disable_external_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") path_params = { "externalContainerDatabaseId": external_container_database_id @@ -13410,7 +13294,6 @@ def enable_external_container_database_stack_monitoring(self, external_container method=method, path_params=path_params, header_params=header_params, - body=enable_external_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13421,15 +13304,14 @@ def enable_external_container_database_stack_monitoring(self, external_container method=method, path_params=path_params, header_params=header_params, - body=enable_external_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_non_container_database_database_management(self, external_non_container_database_id, enable_external_non_container_database_database_management_details, **kwargs): + def disable_external_non_container_database_database_management(self, external_non_container_database_id, **kwargs): """ - Enable Database Management Service for the external non-container database. + Disable Database Management Service for the external non-container database. For more information about the Database Management Service, see `Database Management Service`__. @@ -13441,9 +13323,6 @@ def enable_external_non_container_database_database_management(self, external_no __ 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 @@ -13475,14 +13354,14 @@ def enable_external_non_container_database_database_management(self, external_no :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_non_container_database_database_management API. + Click `here `__ to see an example of how to use disable_external_non_container_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableDatabaseManagement" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableDatabaseManagement" method = "POST" - operation_name = "enable_external_non_container_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseDatabaseManagement" + operation_name = "disable_external_non_container_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ @@ -13495,7 +13374,7 @@ def enable_external_non_container_database_database_management(self, external_no extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_non_container_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_external_non_container_database_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { "externalNonContainerDatabaseId": external_non_container_database_id @@ -13532,7 +13411,6 @@ def enable_external_non_container_database_database_management(self, external_no method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13543,15 +13421,14 @@ def enable_external_non_container_database_database_management(self, external_no method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_non_container_database_operations_insights(self, external_non_container_database_id, enable_external_non_container_database_operations_insights_details, **kwargs): + def disable_external_non_container_database_operations_insights(self, external_non_container_database_id, **kwargs): """ - Enable Operations Insights for the external non-container database. + Disable Operations Insights for the external non-container database. :param str external_non_container_database_id: (required) @@ -13559,9 +13436,6 @@ def enable_external_non_container_database_operations_insights(self, external_no __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableExternalNonContainerDatabaseOperationsInsightsDetails enable_external_non_container_database_operations_insights_details: (required) - Details to enable Operations Insights on the 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 @@ -13593,14 +13467,14 @@ def enable_external_non_container_database_operations_insights(self, external_no :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_non_container_database_operations_insights API. + Click `here `__ to see an example of how to use disable_external_non_container_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableOperationsInsights" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableOperationsInsights" method = "POST" - operation_name = "enable_external_non_container_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseOperationsInsights" + operation_name = "disable_external_non_container_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ @@ -13613,7 +13487,7 @@ def enable_external_non_container_database_operations_insights(self, external_no extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_non_container_database_operations_insights got unknown kwargs: {extra_kwargs!r}") + f"disable_external_non_container_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { "externalNonContainerDatabaseId": external_non_container_database_id @@ -13650,7 +13524,6 @@ def enable_external_non_container_database_operations_insights(self, external_no method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13661,15 +13534,14 @@ def enable_external_non_container_database_operations_insights(self, external_no method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_non_container_database_stack_monitoring(self, external_non_container_database_id, enable_external_non_container_database_stack_monitoring_details, **kwargs): + def disable_external_non_container_database_stack_monitoring(self, external_non_container_database_id, **kwargs): """ - Enable Stack Monitoring for the external non-container database. + Disable Stack Monitoring for the external non-container database. :param str external_non_container_database_id: (required) @@ -13677,9 +13549,6 @@ def enable_external_non_container_database_stack_monitoring(self, external_non_c __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableExternalNonContainerDatabaseStackMonitoringDetails enable_external_non_container_database_stack_monitoring_details: (required) - Details to enable Stack Monitoring on the 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 @@ -13711,14 +13580,14 @@ def enable_external_non_container_database_stack_monitoring(self, external_non_c :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_non_container_database_stack_monitoring API. + Click `here `__ to see an example of how to use disable_external_non_container_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableStackMonitoring" + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/disableStackMonitoring" method = "POST" - operation_name = "enable_external_non_container_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseStackMonitoring" + operation_name = "disable_external_non_container_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/DisableExternalNonContainerDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ @@ -13731,7 +13600,7 @@ def enable_external_non_container_database_stack_monitoring(self, external_non_c extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_non_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"disable_external_non_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") path_params = { "externalNonContainerDatabaseId": external_non_container_database_id @@ -13768,7 +13637,6 @@ def enable_external_non_container_database_stack_monitoring(self, external_non_c method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13779,15 +13647,14 @@ def enable_external_non_container_database_stack_monitoring(self, external_non_c method=method, path_params=path_params, header_params=header_params, - body=enable_external_non_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_pluggable_database_database_management(self, external_pluggable_database_id, enable_external_pluggable_database_database_management_details, **kwargs): + def disable_external_pluggable_database_database_management(self, external_pluggable_database_id, **kwargs): """ - Enable Database Management Service for the external pluggable database. + Disable Database Management Service for the external pluggable database. For more information about the Database Management Service, see `Database Management Service`__. @@ -13799,9 +13666,6 @@ def enable_external_pluggable_database_database_management(self, external_plugga __ 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 @@ -13833,14 +13697,14 @@ def enable_external_pluggable_database_database_management(self, external_plugga :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_pluggable_database_database_management API. + Click `here `__ to see an example of how to use disable_external_pluggable_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableDatabaseManagement" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableDatabaseManagement" method = "POST" - operation_name = "enable_external_pluggable_database_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseDatabaseManagement" + operation_name = "disable_external_pluggable_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ @@ -13853,7 +13717,7 @@ def enable_external_pluggable_database_database_management(self, external_plugga extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_pluggable_database_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_external_pluggable_database_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { "externalPluggableDatabaseId": external_pluggable_database_id @@ -13890,7 +13754,6 @@ def enable_external_pluggable_database_database_management(self, external_plugga method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -13901,15 +13764,14 @@ def enable_external_pluggable_database_database_management(self, external_plugga method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_pluggable_database_operations_insights(self, external_pluggable_database_id, enable_external_pluggable_database_operations_insights_details, **kwargs): + def disable_external_pluggable_database_operations_insights(self, external_pluggable_database_id, **kwargs): """ - Enable Operations Insights for the external pluggable database. + Disable Operations Insights for the external pluggable database. :param str external_pluggable_database_id: (required) @@ -13917,9 +13779,6 @@ def enable_external_pluggable_database_operations_insights(self, external_plugga __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableExternalPluggableDatabaseOperationsInsightsDetails enable_external_pluggable_database_operations_insights_details: (required) - Details to enable Operations Insights on the external pluggable 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 @@ -13951,14 +13810,14 @@ def enable_external_pluggable_database_operations_insights(self, external_plugga :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_pluggable_database_operations_insights API. + Click `here `__ to see an example of how to use disable_external_pluggable_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableOperationsInsights" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableOperationsInsights" method = "POST" - operation_name = "enable_external_pluggable_database_operations_insights" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseOperationsInsights" + operation_name = "disable_external_pluggable_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ @@ -13971,7 +13830,7 @@ def enable_external_pluggable_database_operations_insights(self, external_plugga extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_pluggable_database_operations_insights got unknown kwargs: {extra_kwargs!r}") + f"disable_external_pluggable_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { "externalPluggableDatabaseId": external_pluggable_database_id @@ -14008,7 +13867,6 @@ def enable_external_pluggable_database_operations_insights(self, external_plugga method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14019,15 +13877,14 @@ def enable_external_pluggable_database_operations_insights(self, external_plugga method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_external_pluggable_database_stack_monitoring(self, external_pluggable_database_id, enable_external_pluggable_database_stack_monitoring_details, **kwargs): + def disable_external_pluggable_database_stack_monitoring(self, external_pluggable_database_id, **kwargs): """ - Enable Stack Monitoring for the external pluggable database. + Disable Stack Monitoring for the external pluggable database. :param str external_pluggable_database_id: (required) @@ -14035,9 +13892,6 @@ def enable_external_pluggable_database_stack_monitoring(self, external_pluggable __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnableExternalPluggableDatabaseStackMonitoringDetails enable_external_pluggable_database_stack_monitoring_details: (required) - Details to enable Stack Monitoring on the external pluggable 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 @@ -14069,14 +13923,14 @@ def enable_external_pluggable_database_stack_monitoring(self, external_pluggable :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_external_pluggable_database_stack_monitoring API. + Click `here `__ to see an example of how to use disable_external_pluggable_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableStackMonitoring" + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/disableStackMonitoring" method = "POST" - operation_name = "enable_external_pluggable_database_stack_monitoring" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseStackMonitoring" + operation_name = "disable_external_pluggable_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/DisableExternalPluggableDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ @@ -14089,7 +13943,7 @@ def enable_external_pluggable_database_stack_monitoring(self, external_pluggable extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_external_pluggable_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") + f"disable_external_pluggable_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") path_params = { "externalPluggableDatabaseId": external_pluggable_database_id @@ -14126,7 +13980,6 @@ def enable_external_pluggable_database_stack_monitoring(self, external_pluggable method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14137,15 +13990,14 @@ def enable_external_pluggable_database_stack_monitoring(self, external_pluggable method=method, path_params=path_params, header_params=header_params, - body=enable_external_pluggable_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def enable_pluggable_database_management(self, pluggable_database_id, enable_pluggable_database_management_details, **kwargs): + def disable_pluggable_database_management(self, pluggable_database_id, **kwargs): """ - Enables the Database Management service for an Oracle Pluggable Database located in Oracle Cloud Infrastructure. This service allows the pluggable database to access tools including Metrics and Performance hub. Database Management is enabled at the pluggable database (PDB) level. + Disables the Database Management service for the pluggable database. :param str pluggable_database_id: (required) @@ -14153,9 +14005,6 @@ def enable_pluggable_database_management(self, pluggable_database_id, enable_plu __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.EnablePluggableDatabaseManagementDetails enable_pluggable_database_management_details: (required) - Request to enable the Database Management service for an Oracle Pluggable Database located in Oracle Cloud 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 server error without risk of executing that same action again. Retry tokens expire after 24 @@ -14187,14 +14036,14 @@ def enable_pluggable_database_management(self, pluggable_database_id, enable_plu :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use enable_pluggable_database_management API. + Click `here `__ to see an example of how to use disable_pluggable_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/enablePluggableDatabaseManagement" + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/disablePluggableDatabaseManagement" method = "POST" - operation_name = "enable_pluggable_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/EnablePluggableDatabaseManagement" + operation_name = "disable_pluggable_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/DisablePluggableDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ @@ -14207,7 +14056,7 @@ def enable_pluggable_database_management(self, pluggable_database_id, enable_plu extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"enable_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") + f"disable_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { "pluggableDatabaseId": pluggable_database_id @@ -14244,7 +14093,6 @@ def enable_pluggable_database_management(self, pluggable_database_id, enable_plu method=method, path_params=path_params, header_params=header_params, - body=enable_pluggable_database_management_details, response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -14256,32 +14104,24 @@ def enable_pluggable_database_management(self, pluggable_database_id, enable_plu method=method, path_params=path_params, header_params=header_params, - body=enable_pluggable_database_management_details, response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): + def download_exadata_infrastructure_config_file(self, exadata_infrastructure_id, **kwargs): """ - Initiates a failover of the specified Autonomous Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. - This API should be called in the remote region where the peer database resides. - Below parameter is optional: - - `peerDbId` - Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. - If this parameter is not provided, the failover will happen in the same region. + Downloads the configuration file for the specified 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. :param str opc_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -14290,12 +14130,6 @@ def fail_over_autonomous_database(self, autonomous_database_id, **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 str peer_db_id: (optional) - The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database. - :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. @@ -14308,35 +14142,33 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 stream :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 download_exadata_infrastructure_config_file API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/failover" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/actions/downloadConfigFile" method = "POST" - operation_name = "fail_over_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/FailOverAutonomousDatabase" + operation_name = "download_exadata_infrastructure_config_file" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/DownloadExadataInfrastructureConfigFile" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "opc_retry_token", "opc_request_id", - "peer_db_id" + "opc_retry_token" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"fail_over_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"download_exadata_infrastructure_config_file got unknown kwargs: {extra_kwargs!r}") 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} @@ -14345,17 +14177,11 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - query_params = { - "peerDbId": kwargs.get("peer_db_id", 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", + "accept": "application/octet-stream", "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} @@ -14374,9 +14200,8 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14386,30 +14211,32 @@ def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def failover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def download_oneoff_patch(self, oneoff_patch_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. + Download one-off patch. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str oneoff_patch_id: (required) + The one-off patch `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 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 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` @@ -14428,33 +14255,34 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DownloadOneoffPatch` :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 download_oneoff_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/failover" + required_arguments = ['oneoffPatchId'] + resource_path = "/oneoffPatches/{oneoffPatchId}/actions/downloadOneoffPatch" method = "POST" - operation_name = "failover_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/FailoverAutonomousContainerDatabaseDataguardAssociation" + operation_name = "download_oneoff_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/DownloadOneoffPatch" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"failover_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"download_oneoff_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "oneoffPatchId": oneoff_patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14466,6 +14294,8 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou 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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -14477,6 +14307,7 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -14485,7 +14316,7 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + response_type="DownloadOneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14496,38 +14327,36 @@ def failover_autonomous_container_database_dataguard_association(self, autonomou method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + response_type="DownloadOneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def failover_data_guard_association(self, database_id, data_guard_association_id, failover_data_guard_association_details, **kwargs): + def download_validation_report(self, exadata_infrastructure_id, vm_cluster_network_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. + Downloads the network validation report file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - :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 str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str vm_cluster_network_id: (required) + The VM cluster network `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 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. @@ -14541,33 +14370,34 @@ def failover_data_guard_association(self, database_id, data_guard_association_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 stream :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 download_validation_report API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'dataGuardAssociationId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/failover" + required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadValidationReport" method = "POST" - operation_name = "failover_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/FailoverDataGuardAssociation" + operation_name = "download_validation_report" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DownloadValidationReport" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"failover_data_guard_association got unknown kwargs: {extra_kwargs!r}") + f"download_validation_report got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_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} @@ -14577,9 +14407,10 @@ def failover_data_guard_association(self, database_id, data_guard_association_id raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { - "accept": "application/json", + "accept": "application/octet-stream", "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} @@ -14590,6 +14421,7 @@ def failover_data_guard_association(self, database_id, data_guard_association_id if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -14598,8 +14430,7 @@ def failover_data_guard_association(self, database_id, data_guard_association_id method=method, path_params=path_params, header_params=header_params, - body=failover_data_guard_association_details, - response_type="DataGuardAssociation", + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14610,25 +14441,26 @@ def failover_data_guard_association(self, database_id, data_guard_association_id method=method, path_params=path_params, header_params=header_params, - body=failover_data_guard_association_details, - response_type="DataGuardAssociation", + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def generate_autonomous_database_wallet(self, autonomous_database_id, generate_autonomous_database_wallet_details, **kwargs): + def download_vm_cluster_network_config_file(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): """ - Creates and downloads a wallet for the specified Autonomous Database. + Downloads the configuration file for the specified VM cluster network. Applies to Exadata Cloud@Customer instances only. - :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 oci.database.models.GenerateAutonomousDatabaseWalletDetails generate_autonomous_database_wallet_details: (required) - Request to create a new Autonomous Database wallet. + :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. @@ -14656,14 +14488,14 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a :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 download_vm_cluster_network_config_file API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/generateWallet" + required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/downloadConfigFile" method = "POST" - operation_name = "generate_autonomous_database_wallet" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/GenerateAutonomousDatabaseWallet" + operation_name = "download_vm_cluster_network_config_file" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/DownloadVmClusterNetworkConfigFile" # Don't accept unknown kwargs expected_kwargs = [ @@ -14675,10 +14507,11 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"generate_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") + f"download_vm_cluster_network_config_file got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_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} @@ -14711,7 +14544,6 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a method=method, path_params=path_params, header_params=header_params, - body=generate_autonomous_database_wallet_details, response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -14723,36 +14555,25 @@ def generate_autonomous_database_wallet(self, autonomous_database_id, generate_a method=method, path_params=path_params, header_params=header_params, - body=generate_autonomous_database_wallet_details, response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, generate_recommended_network_details, **kwargs): + def enable_autonomous_database_management(self, autonomous_database_id, **kwargs): """ - Generates a recommended Cloud@Customer VM cluster network configuration. + Enables Database Management for Autonomous Database. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ 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 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. @@ -14765,33 +14586,32 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_autonomous_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/actions/generateRecommendedNetwork" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableDatabaseManagement" method = "POST" - operation_name = "generate_recommended_vm_cluster_network" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/GenerateRecommendedVmClusterNetwork" + operation_name = "enable_autonomous_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/EnableAutonomousDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "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( - f"generate_recommended_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") + f"enable_autonomous_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14803,8 +14623,7 @@ 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) + "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} @@ -14815,7 +14634,6 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -14824,8 +14642,6 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen method=method, path_params=path_params, header_params=header_params, - body=generate_recommended_network_details, - response_type="VmClusterNetworkDetails", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14836,20 +14652,18 @@ def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, gen method=method, path_params=path_params, header_params=header_params, - body=generate_recommended_network_details, - response_type="VmClusterNetworkDetails", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_application_vip(self, application_vip_id, **kwargs): + def enable_autonomous_database_operations_insights(self, autonomous_database_id, **kwargs): """ - Gets information about a specified application virtual IP (VIP) address. + Enables the specified Autonomous Database with Operations Insights. - :param str application_vip_id: (required) - The `OCID`__ of the application virtual IP (VIP) address. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -14868,18 +14682,18 @@ def get_application_vip(self, application_vip_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ApplicationVip` + :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_application_vip API. + Click `here `__ to see an example of how to use enable_autonomous_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['applicationVipId'] - resource_path = "/applicationVip/{applicationVipId}" - method = "GET" - operation_name = "get_application_vip" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/GetApplicationVip" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableOperationsInsights" + method = "POST" + operation_name = "enable_autonomous_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/EnableAutonomousDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ @@ -14890,10 +14704,10 @@ def get_application_vip(self, application_vip_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_application_vip got unknown kwargs: {extra_kwargs!r}") + f"enable_autonomous_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { - "applicationVipId": application_vip_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14924,7 +14738,6 @@ def get_application_vip(self, application_vip_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -14935,22 +14748,39 @@ def get_application_vip(self, application_vip_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def enable_database_management(self, database_id, enable_database_management_details, **kwargs): """ - Gets information about the specified Autonomous Container Database. + Enables the Database Management service for an Oracle Database located in Oracle Cloud Infrastructure. This service allows the database to access tools including Metrics and Performance hub. Database Management is enabled at the container database (CDB) level. - :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 oci.database.models.EnableDatabaseManagementDetails enable_database_management_details: (required) + Request to enable the Database Management service for an Oracle Database located in Oracle Cloud 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 + 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. @@ -14963,27 +14793,34 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :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 enable_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" - method = "GET" - operation_name = "get_autonomous_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/GetAutonomousContainerDatabase" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/enableDatabaseManagement" + method = "POST" + operation_name = "enable_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/EnableDatabaseManagement" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") + f"enable_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -14994,8 +14831,12 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -15004,6 +14845,7 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15012,7 +14854,8 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase", + body=enable_database_management_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15023,26 +14866,44 @@ def get_autonomous_container_database(self, autonomous_container_database_id, ** method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase", + body=enable_database_management_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def enable_external_container_database_database_management(self, external_container_database_id, enable_external_container_database_database_management_details, **kwargs): """ - Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database. + 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 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 autonomous_container_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :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. - __ 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. @@ -15056,28 +14917,34 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_container_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" - method = "GET" - operation_name = "get_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/GetAutonomousContainerDatabaseDataguardAssociation" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/enableDatabaseManagement" + method = "POST" + operation_name = "enable_external_container_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/EnableExternalContainerDatabaseDatabaseManagement" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"enable_external_container_database_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_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} @@ -15088,8 +14955,12 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -15098,6 +14969,7 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15106,7 +14978,7 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=enable_external_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15117,25 +14989,40 @@ def get_autonomous_container_database_dataguard_association(self, autonomous_con method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=enable_external_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_container_database_resource_usage(self, autonomous_container_database_id, **kwargs): + def enable_external_container_database_stack_monitoring(self, external_container_database_id, enable_external_container_database_stack_monitoring_details, **kwargs): """ - Get resource usage details for the specified Autonomous Container Database. + Enable Stack Monitoring for the external container database. - :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 oci.database.models.EnableExternalContainerDatabaseStackMonitoringDetails enable_external_container_database_stack_monitoring_details: (required) + Details to enable Stack Monitoring on the 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. @@ -15148,32 +15035,34 @@ def get_autonomous_container_database_resource_usage(self, autonomous_container_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousContainerDatabaseResourceUsage` + :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_resource_usage API. + Click `here `__ to see an example of how to use enable_external_container_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/resourceUsage" - method = "GET" - operation_name = "get_autonomous_container_database_resource_usage" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/GetAutonomousContainerDatabaseResourceUsage" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/enableStackMonitoring" + method = "POST" + operation_name = "enable_external_container_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/EnableExternalContainerDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_container_database_resource_usage got unknown kwargs: {extra_kwargs!r}") + f"enable_external_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") 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} @@ -15185,7 +15074,9 @@ def get_autonomous_container_database_resource_usage(self, autonomous_container_ 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} @@ -15196,6 +15087,7 @@ def get_autonomous_container_database_resource_usage(self, autonomous_container_ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15204,7 +15096,7 @@ def get_autonomous_container_database_resource_usage(self, autonomous_container_ method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseResourceUsage", + body=enable_external_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15215,25 +15107,44 @@ def get_autonomous_container_database_resource_usage(self, autonomous_container_ method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseResourceUsage", + body=enable_external_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database(self, autonomous_database_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 the details of the specified Autonomous Database. + 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 autonomous_database_id: (required) - The database `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.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. @@ -15246,32 +15157,34 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_non_container_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" - method = "GET" - operation_name = "get_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/GetAutonomousDatabase" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableDatabaseManagement" + method = "POST" + operation_name = "enable_external_non_container_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"enable_external_non_container_database_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15283,7 +15196,9 @@ def get_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), + "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} @@ -15294,6 +15209,7 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15302,7 +15218,7 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + body=enable_external_non_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15313,25 +15229,40 @@ def get_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + body=enable_external_non_container_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): + def enable_external_non_container_database_operations_insights(self, external_non_container_database_id, enable_external_non_container_database_operations_insights_details, **kwargs): """ - Gets information about the specified Autonomous Database backup. + Enable Operations Insights for the external non-container database. - :param str autonomous_database_backup_id: (required) - The `OCID`__ of the Autonomous Database backup. + :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.EnableExternalNonContainerDatabaseOperationsInsightsDetails enable_external_non_container_database_operations_insights_details: (required) + Details to enable Operations Insights on the 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. @@ -15344,32 +15275,34 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_non_container_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseBackupId'] - resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" - method = "GET" - operation_name = "get_autonomous_database_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/GetAutonomousDatabaseBackup" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableOperationsInsights" + method = "POST" + operation_name = "enable_external_non_container_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") + f"enable_external_non_container_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseBackupId": autonomous_database_backup_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15381,7 +15314,9 @@ def get_autonomous_database_backup(self, autonomous_database_backup_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} @@ -15392,6 +15327,7 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15400,7 +15336,7 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseBackup", + body=enable_external_non_container_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15411,30 +15347,40 @@ def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseBackup", + body=enable_external_non_container_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database_dataguard_association(self, autonomous_database_id, autonomous_database_dataguard_association_id, **kwargs): + def enable_external_non_container_database_stack_monitoring(self, external_non_container_database_id, enable_external_non_container_database_stack_monitoring_details, **kwargs): """ - Gets an Autonomous Data Guard-enabled database associated with the specified Autonomous Database. + Enable Stack Monitoring for the external non-container database. - :param str autonomous_database_id: (required) - The database `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 str autonomous_database_dataguard_association_id: (required) - The Autonomous Container Database-Autonomous Data Guard association `OCID`__. + :param oci.database.models.EnableExternalNonContainerDatabaseStackMonitoringDetails enable_external_non_container_database_stack_monitoring_details: (required) + Details to enable Stack Monitoring on the 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 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. @@ -15447,33 +15393,34 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_non_container_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId', 'autonomousDatabaseDataguardAssociationId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations/{autonomousDatabaseDataguardAssociationId}" - method = "GET" - operation_name = "get_autonomous_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseDataguardAssociation/GetAutonomousDatabaseDataguardAssociation" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}/actions/enableStackMonitoring" + method = "POST" + operation_name = "enable_external_non_container_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/EnableExternalNonContainerDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"enable_external_non_container_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id, - "autonomousDatabaseDataguardAssociationId": autonomous_database_dataguard_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} @@ -15485,7 +15432,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} @@ -15496,6 +15445,7 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15504,7 +15454,7 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseDataguardAssociation", + body=enable_external_non_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15515,20 +15465,44 @@ def get_autonomous_database_dataguard_association(self, autonomous_database_id, method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseDataguardAssociation", + body=enable_external_non_container_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database_regional_wallet(self, **kwargs): + def enable_external_pluggable_database_database_management(self, external_pluggable_database_id, enable_external_pluggable_database_database_management_details, **kwargs): """ - Gets the Autonomous Database regional wallet details. + 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 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. @@ -15541,34 +15515,48 @@ def get_autonomous_database_regional_wallet(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_pluggable_database_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabases/wallet" - method = "GET" - operation_name = "get_autonomous_database_regional_wallet" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/GetAutonomousDatabaseRegionalWallet" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableDatabaseManagement" + method = "POST" + operation_name = "enable_external_pluggable_database_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database_regional_wallet got unknown kwargs: {extra_kwargs!r}") + f"enable_external_pluggable_database_database_management got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -15579,14 +15567,16 @@ def get_autonomous_database_regional_wallet(self, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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", + body=enable_external_pluggable_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15595,26 +15585,42 @@ def get_autonomous_database_regional_wallet(self, **kwargs): return self.base_client.call_api( resource_path=resource_path, method=method, + path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseWallet", + body=enable_external_pluggable_database_database_management_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database_software_image(self, autonomous_database_software_image_id, **kwargs): + def enable_external_pluggable_database_operations_insights(self, external_pluggable_database_id, enable_external_pluggable_database_operations_insights_details, **kwargs): """ - Gets information about the specified Autonomous Database Software Image. + Enable Operations Insights for the external pluggable database. - :param str autonomous_database_software_image_id: (required) - The Autonomous Database Software Image `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.EnableExternalPluggableDatabaseOperationsInsightsDetails enable_external_pluggable_database_operations_insights_details: (required) + Details to enable Operations Insights on the external pluggable 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. @@ -15627,32 +15633,34 @@ def get_autonomous_database_software_image(self, autonomous_database_software_im allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseSoftwareImage` + :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_software_image API. + Click `here `__ to see an example of how to use enable_external_pluggable_database_operations_insights API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseSoftwareImageId'] - resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" - method = "GET" - operation_name = "get_autonomous_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/GetAutonomousDatabaseSoftwareImage" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableOperationsInsights" + method = "POST" + operation_name = "enable_external_pluggable_database_operations_insights" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseOperationsInsights" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"enable_external_pluggable_database_operations_insights got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15664,7 +15672,9 @@ def get_autonomous_database_software_image(self, autonomous_database_software_im 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} @@ -15675,6 +15685,7 @@ def get_autonomous_database_software_image(self, autonomous_database_software_im if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15683,7 +15694,7 @@ def get_autonomous_database_software_image(self, autonomous_database_software_im method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseSoftwareImage", + body=enable_external_pluggable_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15694,25 +15705,40 @@ def get_autonomous_database_software_image(self, autonomous_database_software_im method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseSoftwareImage", + body=enable_external_pluggable_database_operations_insights_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): + def enable_external_pluggable_database_stack_monitoring(self, external_pluggable_database_id, enable_external_pluggable_database_stack_monitoring_details, **kwargs): """ - Gets the wallet details for the specified Autonomous Database. + Enable Stack Monitoring for the external pluggable database. - :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.EnableExternalPluggableDatabaseStackMonitoringDetails enable_external_pluggable_database_stack_monitoring_details: (required) + Details to enable Stack Monitoring on the external pluggable 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. @@ -15725,32 +15751,34 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 enable_external_pluggable_database_stack_monitoring API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" - method = "GET" - operation_name = "get_autonomous_database_wallet" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/GetAutonomousDatabaseWallet" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}/actions/enableStackMonitoring" + method = "POST" + operation_name = "enable_external_pluggable_database_stack_monitoring" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/EnableExternalPluggableDatabaseStackMonitoring" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") + f"enable_external_pluggable_database_stack_monitoring got unknown kwargs: {extra_kwargs!r}") 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} @@ -15762,7 +15790,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} @@ -15773,6 +15803,7 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15781,7 +15812,7 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseWallet", + body=enable_external_pluggable_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15792,22 +15823,40 @@ def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabaseWallet", + body=enable_external_pluggable_database_stack_monitoring_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): + def enable_pluggable_database_management(self, pluggable_database_id, enable_pluggable_database_management_details, **kwargs): """ - **Deprecated.** Use the :func:`get_cloud_exadata_infrastructure` operation to get details of an Exadata Infrastructure resource and the :func:`get_cloud_autonomous_vm_cluster` operation to get details of an Autonomous Exadata VM cluster. + Enables the Database Management service for an Oracle Pluggable Database located in Oracle Cloud Infrastructure. This service allows the pluggable database to access tools including Metrics and Performance hub. Database Management is enabled at the pluggable database (PDB) level. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous Exadata Infrastructure `OCID`__. + :param str pluggable_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.EnablePluggableDatabaseManagementDetails enable_pluggable_database_management_details: (required) + Request to enable the Database Management service for an Oracle Pluggable Database located in Oracle Cloud 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 + 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. @@ -15820,27 +15869,34 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :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 enable_pluggable_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" - method = "GET" - operation_name = "get_autonomous_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/GetAutonomousExadataInfrastructure" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/enablePluggableDatabaseManagement" + method = "POST" + operation_name = "enable_pluggable_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/EnablePluggableDatabaseManagement" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"enable_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15851,8 +15907,12 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -15861,6 +15921,7 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15869,7 +15930,8 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousExadataInfrastructure", + body=enable_pluggable_database_management_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15880,22 +15942,46 @@ def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructur method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousExadataInfrastructure", + body=enable_pluggable_database_management_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_patch(self, autonomous_patch_id, **kwargs): + def fail_over_autonomous_database(self, autonomous_database_id, **kwargs): """ - Gets information about a specific autonomous patch. + Initiates a failover of the specified Autonomous Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. + This API should be called in the remote region where the peer database resides. + Below parameter is optional: + - `peerDbId` + Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. + If this parameter is not provided, the failover will happen in the same region. - :param str autonomous_patch_id: (required) - The autonomous patch `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. + + :param str peer_db_id: (optional) + The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database. + :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. @@ -15908,27 +15994,35 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.AutonomousDatabase` :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 fail_over_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousPatchId'] - resource_path = "/autonomousPatches/{autonomousPatchId}" - method = "GET" - operation_name = "get_autonomous_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousPatch/GetAutonomousPatch" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/failover" + method = "POST" + operation_name = "fail_over_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/FailOverAutonomousDatabase" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "if_match", + "opc_retry_token", + "opc_request_id", + "peer_db_id" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_autonomous_patch got unknown kwargs: {extra_kwargs!r}") + f"fail_over_autonomous_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousPatchId": autonomous_patch_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -15937,10 +16031,19 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "peerDbId": kwargs.get("peer_db_id", 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), + "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} retry_strategy = self.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -15949,6 +16052,7 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -15956,8 +16060,9 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="AutonomousPatch", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -15967,25 +16072,35 @@ def get_autonomous_patch(self, autonomous_patch_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="AutonomousPatch", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_virtual_machine(self, autonomous_virtual_machine_id, **kwargs): + def failover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Gets the details of specific Autonomous Virtual Machine. + 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_virtual_machine_id: (required) - The Autonomous Virtual machine `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. @@ -15999,32 +16114,33 @@ def get_autonomous_virtual_machine(self, autonomous_virtual_machine_id, **kwargs allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVirtualMachine` + :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_autonomous_virtual_machine API. + Click `here `__ to see an example of how to use failover_autonomous_container_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVirtualMachineId'] - resource_path = "/autonomousVirtualMachines/{autonomousVirtualMachineId}" - method = "GET" - operation_name = "get_autonomous_virtual_machine" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVirtualMachine/GetAutonomousVirtualMachine" + required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/failover" + method = "POST" + operation_name = "failover_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/FailoverAutonomousContainerDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_virtual_machine got unknown kwargs: {extra_kwargs!r}") + f"failover_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousVirtualMachineId": autonomous_virtual_machine_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} @@ -16036,7 +16152,7 @@ def get_autonomous_virtual_machine(self, autonomous_virtual_machine_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} @@ -16055,7 +16171,7 @@ def get_autonomous_virtual_machine(self, autonomous_virtual_machine_id, **kwargs method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVirtualMachine", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16066,24 +16182,38 @@ def get_autonomous_virtual_machine(self, autonomous_virtual_machine_id, **kwargs method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVirtualMachine", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): + def failover_data_guard_association(self, database_id, data_guard_association_id, failover_data_guard_association_details, **kwargs): """ - Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system. To get information about an Autonomous VM Cluster in the Oracle cloud, see :func:`get_cloud_autonomous_vm_cluster`. + 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 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 str opc_request_id: (optional) - Unique identifier for the request. + :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 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. @@ -16097,32 +16227,33 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DataGuardAssociation` :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 failover_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" - method = "GET" - operation_name = "get_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/GetAutonomousVmCluster" + required_arguments = ['databaseId', 'dataGuardAssociationId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/failover" + method = "POST" + operation_name = "failover_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/FailoverDataGuardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"failover_data_guard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_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} @@ -16134,7 +16265,7 @@ def get_autonomous_vm_cluster(self, autonomous_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} @@ -16153,7 +16284,8 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVmCluster", + body=failover_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16164,25 +16296,36 @@ def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVmCluster", + body=failover_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **kwargs): + def generate_autonomous_database_wallet(self, autonomous_database_id, generate_autonomous_database_wallet_details, **kwargs): """ - Get the resource usage details for the specified Autonomous Exadata VM cluster. + Creates and downloads a wallet for the specified Autonomous Database. - :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 + :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. @@ -16195,32 +16338,33 @@ def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **k allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVmClusterResourceUsage` + :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_vm_cluster_resource_usage API. + Click `here `__ to see an example of how to use generate_autonomous_database_wallet API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/resourceUsage" - method = "GET" - operation_name = "get_autonomous_vm_cluster_resource_usage" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/GetAutonomousVmClusterResourceUsage" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/generateWallet" + method = "POST" + operation_name = "generate_autonomous_database_wallet" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/GenerateAutonomousDatabaseWallet" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"get_autonomous_vm_cluster_resource_usage got unknown kwargs: {extra_kwargs!r}") + f"generate_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") 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} @@ -16230,9 +16374,10 @@ def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **k raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -16243,6 +16388,7 @@ def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **k if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -16251,7 +16397,8 @@ def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **k method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVmClusterResourceUsage", + body=generate_autonomous_database_wallet_details, + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16262,22 +16409,36 @@ def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **k method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousVmClusterResourceUsage", + body=generate_autonomous_database_wallet_details, + response_type="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_backup(self, backup_id, **kwargs): + def generate_recommended_vm_cluster_network(self, exadata_infrastructure_id, generate_recommended_network_details, **kwargs): """ - Gets information about the specified backup. + Generates a recommended Cloud@Customer VM cluster network configuration. - :param str backup_id: (required) - The backup `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.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. @@ -16290,27 +16451,33 @@ def get_backup(self, backup_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.VmClusterNetworkDetails` :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 generate_recommended_vm_cluster_network API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupId'] - resource_path = "/backups/{backupId}" - method = "GET" - operation_name = "get_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/GetBackup" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/actions/generateRecommendedNetwork" + method = "POST" + operation_name = "generate_recommended_vm_cluster_network" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/GenerateRecommendedVmClusterNetwork" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_backup got unknown kwargs: {extra_kwargs!r}") + f"generate_recommended_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupId": backup_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16321,8 +16488,11 @@ def get_backup(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), + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -16331,6 +16501,7 @@ def get_backup(self, backup_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -16339,7 +16510,8 @@ def get_backup(self, backup_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Backup", + body=generate_recommended_network_details, + response_type="VmClusterNetworkDetails", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16350,19 +16522,20 @@ def get_backup(self, backup_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Backup", + body=generate_recommended_network_details, + response_type="VmClusterNetworkDetails", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_backup_destination(self, backup_destination_id, **kwargs): + def get_application_vip(self, application_vip_id, **kwargs): """ - Gets information about the specified backup destination in an Exadata Cloud@Customer system. + Gets information about a specified application virtual IP (VIP) address. - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :param str application_vip_id: (required) + The `OCID`__ of the application virtual IP (VIP) address. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -16381,18 +16554,18 @@ def get_backup_destination(self, backup_destination_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ApplicationVip` :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 get_application_vip API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupDestinationId'] - resource_path = "/backupDestinations/{backupDestinationId}" + required_arguments = ['applicationVipId'] + resource_path = "/applicationVip/{applicationVipId}" method = "GET" - operation_name = "get_backup_destination" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/GetBackupDestination" + operation_name = "get_application_vip" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVip/GetApplicationVip" # Don't accept unknown kwargs expected_kwargs = [ @@ -16403,10 +16576,10 @@ def get_backup_destination(self, backup_destination_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_backup_destination got unknown kwargs: {extra_kwargs!r}") + f"get_application_vip got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupDestinationId": backup_destination_id + "applicationVipId": application_vip_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16437,7 +16610,7 @@ def get_backup_destination(self, backup_destination_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="BackupDestination", + response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16448,25 +16621,22 @@ def get_backup_destination(self, backup_destination_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="BackupDestination", + response_type="ApplicationVip", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwargs): + def get_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Gets information about the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Custustomer systems, see :func:`get_autonomous_vm_cluster`. + Gets information about the specified Autonomous Container Database. - :param str cloud_autonomous_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 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. @@ -16479,32 +16649,27 @@ def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwar allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudAutonomousVmCluster` + :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_cloud_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use get_autonomous_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" method = "GET" - operation_name = "get_cloud_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/GetCloudAutonomousVmCluster" + operation_name = "get_autonomous_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/GetAutonomousContainerDatabase" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16515,10 +16680,8 @@ def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwar 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -16535,7 +16698,7 @@ def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="CloudAutonomousVmCluster", + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16546,24 +16709,26 @@ def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="CloudAutonomousVmCluster", + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_cluster_id, **kwargs): + def get_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Get the resource usage details for the specified Cloud Autonomous Exadata VM cluster. + Gets an Autonomous Container Database enabled with Autonomous Data Guard associated with the specified Autonomous Container Database. - :param str cloud_autonomous_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 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. @@ -16577,32 +16742,28 @@ def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_clu allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudAutonomousVmClusterResourceUsage` + :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_autonomous_vm_cluster_resource_usage API. + Click `here `__ to see an example of how to use get_autonomous_container_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/resourceUsage" + required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" method = "GET" - operation_name = "get_cloud_autonomous_vm_cluster_resource_usage" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/GetCloudAutonomousVmClusterResourceUsage" + operation_name = "get_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/GetAutonomousContainerDatabaseDataguardAssociation" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_cloud_autonomous_vm_cluster_resource_usage got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_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} @@ -16613,10 +16774,8 @@ def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_clu 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -16633,7 +16792,7 @@ def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_clu method=method, path_params=path_params, header_params=header_params, - response_type="CloudAutonomousVmClusterResourceUsage", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16644,19 +16803,19 @@ def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_clu method=method, path_params=path_params, header_params=header_params, - response_type="CloudAutonomousVmClusterResourceUsage", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): + def get_autonomous_container_database_resource_usage(self, autonomous_container_database_id, **kwargs): """ - Gets information about the specified cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Get resource usage details for the specified Autonomous Container Database. - :param str cloud_exadata_infrastructure_id: (required) - The cloud 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 @@ -16675,18 +16834,18 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabaseResourceUsage` :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 get_autonomous_container_database_resource_usage API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" - method = "GET" - operation_name = "get_cloud_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/GetCloudExadataInfrastructure" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/resourceUsage" + method = "GET" + operation_name = "get_autonomous_container_database_resource_usage" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/GetAutonomousContainerDatabaseResourceUsage" # Don't accept unknown kwargs expected_kwargs = [ @@ -16697,10 +16856,10 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_container_database_resource_usage got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16731,7 +16890,7 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="CloudExadataInfrastructure", + response_type="AutonomousContainerDatabaseResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16742,30 +16901,25 @@ def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="CloudExadataInfrastructure", + response_type="AutonomousContainerDatabaseResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_infrastructure_id, **kwargs): + def get_autonomous_database(self, autonomous_database_id, **kwargs): """ - Gets unallocated resources information for the specified Cloud Exadata infrastructure. + Gets the details of the specified Autonomous Database. - :param str cloud_exadata_infrastructure_id: (required) - The cloud 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 list[str] db_servers: (optional) - The list of `OCIDs`__ of the Db servers. - - __ 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. @@ -16778,33 +16932,32 @@ def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_i allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudExadataInfrastructureUnallocatedResources` + :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_exadata_infrastructure_unallocated_resources API. + Click `here `__ to see an example of how to use get_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/unAllocatedResources" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" method = "GET" - operation_name = "get_cloud_exadata_infrastructure_unallocated_resources" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructureUnallocatedResources/GetCloudExadataInfrastructureUnallocatedResources" + operation_name = "get_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/GetAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "db_servers" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_exadata_infrastructure_unallocated_resources got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16813,11 +16966,6 @@ def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_i if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - query_params = { - "dbServers": self.base_client.generate_collection_format_param(kwargs.get("db_servers", missing), 'multi') - } - 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", @@ -16839,9 +16987,8 @@ def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_i resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="CloudExadataInfrastructureUnallocatedResources", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16851,21 +16998,20 @@ def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_i resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="CloudExadataInfrastructureUnallocatedResources", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): + def get_autonomous_database_backup(self, autonomous_database_backup_id, **kwargs): """ - Gets information about the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Gets information about the specified Autonomous Database backup. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `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 @@ -16884,18 +17030,18 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseBackup` :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 get_autonomous_database_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}" + required_arguments = ['autonomousDatabaseBackupId'] + resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" method = "GET" - operation_name = "get_cloud_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/GetCloudVmCluster" + operation_name = "get_autonomous_database_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/GetAutonomousDatabaseBackup" # Don't accept unknown kwargs expected_kwargs = [ @@ -16906,10 +17052,10 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "autonomousDatabaseBackupId": autonomous_database_backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -16940,7 +17086,7 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="CloudVmCluster", + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -16951,20 +17097,24 @@ def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="CloudVmCluster", + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): + def get_autonomous_database_dataguard_association(self, autonomous_database_id, autonomous_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. + Gets an Autonomous Data Guard-enabled database associated with 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 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 @@ -16983,18 +17133,18 @@ def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseDataguardAssociation` :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 get_autonomous_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" + required_arguments = ['autonomousDatabaseId', 'autonomousDatabaseDataguardAssociationId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations/{autonomousDatabaseDataguardAssociationId}" method = "GET" - operation_name = "get_cloud_vm_cluster_iorm_config" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/GetCloudVmClusterIormConfig" + operation_name = "get_autonomous_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseDataguardAssociation/GetAutonomousDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ @@ -17005,10 +17155,11 @@ def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_vm_cluster_iorm_config got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_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} @@ -17039,7 +17190,7 @@ 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="AutonomousDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17050,24 +17201,100 @@ 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="AutonomousDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): + def get_autonomous_database_regional_wallet(self, **kwargs): """ - Gets information about a specified maintenance update package for a cloud VM cluster. Applies to Exadata Cloud Service instances only. + Gets the Autonomous Database regional wallet details. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str opc_request_id: (optional) + Unique identifier for the request. - __ 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 update_id: (required) - The `OCID`__ of the maintenance update. + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_autonomous_database_regional_wallet API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/autonomousDatabases/wallet" + method = "GET" + operation_name = "get_autonomous_database_regional_wallet" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/GetAutonomousDatabaseRegionalWallet" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_autonomous_database_regional_wallet got unknown kwargs: {extra_kwargs!r}") + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + response_type="AutonomousDatabaseWallet", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + response_type="AutonomousDatabaseWallet", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_autonomous_database_software_image(self, autonomous_database_software_image_id, **kwargs): + """ + Gets information about the specified Autonomous Database Software Image. + + + :param str autonomous_database_software_image_id: (required) + The Autonomous Database Software Image `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -17086,18 +17313,18 @@ def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseSoftwareImage` :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 get_autonomous_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId', 'updateId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates/{updateId}" + required_arguments = ['autonomousDatabaseSoftwareImageId'] + resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" method = "GET" - operation_name = "get_cloud_vm_cluster_update" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Update/GetCloudVmClusterUpdate" + operation_name = "get_autonomous_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/GetAutonomousDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ @@ -17108,11 +17335,10 @@ def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_id, - "updateId": update_id + "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17143,7 +17369,7 @@ 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", + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17154,24 +17380,19 @@ 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", + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_history_entry_id, **kwargs): + def get_autonomous_database_wallet(self, autonomous_database_id, **kwargs): """ - Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud Service instances only. - - - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + Gets the wallet details for the specified Autonomous Database. - __ 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. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -17190,18 +17411,18 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.AutonomousDatabaseWallet` :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 get_autonomous_database_wallet API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId', 'updateHistoryEntryId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" method = "GET" - operation_name = "get_cloud_vm_cluster_update_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/UpdateHistoryEntry/GetCloudVmClusterUpdateHistoryEntry" + operation_name = "get_autonomous_database_wallet" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/GetAutonomousDatabaseWallet" # Don't accept unknown kwargs expected_kwargs = [ @@ -17212,11 +17433,10 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_cloud_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") 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} @@ -17247,7 +17467,7 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ method=method, path_params=path_params, header_params=header_params, - response_type="UpdateHistoryEntry", + response_type="AutonomousDatabaseWallet", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17258,25 +17478,22 @@ def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_ method=method, path_params=path_params, header_params=header_params, - response_type="UpdateHistoryEntry", + response_type="AutonomousDatabaseWallet", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_console_connection(self, db_node_id, console_connection_id, **kwargs): + def get_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Gets the specified database node console connection's information. + **Deprecated.** Use the :func:`get_cloud_exadata_infrastructure` operation to get details of an Exadata Infrastructure resource and the :func:`get_cloud_autonomous_vm_cluster` operation to get details of an Autonomous Exadata VM cluster. - :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 - :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. @@ -17289,28 +17506,27 @@ def get_console_connection(self, db_node_id, console_connection_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousExadataInfrastructure` :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 get_autonomous_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleConnectionId'] - resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" method = "GET" - operation_name = "get_console_connection" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/GetConsoleConnection" + operation_name = "get_autonomous_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/GetAutonomousExadataInfrastructure" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_console_connection got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleConnectionId": console_connection_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17339,7 +17555,7 @@ def get_console_connection(self, db_node_id, console_connection_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleConnection", + response_type="AutonomousExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17350,28 +17566,22 @@ def get_console_connection(self, db_node_id, console_connection_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleConnection", + response_type="AutonomousExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_console_history(self, db_node_id, console_history_id, **kwargs): + def get_autonomous_patch(self, autonomous_patch_id, **kwargs): """ - Gets information about the specified database node console history. + Gets information about a specific autonomous patch. - :param str db_node_id: (required) - The database node `OCID`__. + :param str autonomous_patch_id: (required) + The autonomous patch `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_history_id: (required) - The OCID of the console history. - - :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. @@ -17384,33 +17594,27 @@ def get_console_history(self, db_node_id, console_history_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleHistory` + :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_console_history API. + Click `here `__ to see an example of how to use get_autonomous_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleHistoryId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" + required_arguments = ['autonomousPatchId'] + resource_path = "/autonomousPatches/{autonomousPatchId}" method = "GET" - operation_name = "get_console_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/GetConsoleHistory" + operation_name = "get_autonomous_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousPatch/GetAutonomousPatch" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_console_history got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleHistoryId": console_history_id + "autonomousPatchId": autonomous_patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17421,10 +17625,8 @@ def get_console_history(self, db_node_id, console_history_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -17441,7 +17643,7 @@ def get_console_history(self, db_node_id, console_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleHistory", + response_type="AutonomousPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17452,25 +17654,22 @@ def get_console_history(self, db_node_id, console_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ConsoleHistory", + response_type="AutonomousPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_console_history_content(self, db_node_id, console_history_id, **kwargs): + def get_autonomous_virtual_machine(self, autonomous_virtual_machine_id, **kwargs): """ - Retrieves the specified database node console history contents upto a megabyte. + Gets the details of specific Autonomous Virtual Machine. - :param str db_node_id: (required) - The database node `OCID`__. + :param str autonomous_virtual_machine_id: (required) + The Autonomous Virtual machine `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_history_id: (required) - The OCID of the console history. - :param str opc_request_id: (optional) Unique identifier for the request. @@ -17486,18 +17685,18 @@ def get_console_history_content(self, db_node_id, console_history_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type stream + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousVirtualMachine` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_console_history_content API. + Click `here `__ to see an example of how to use get_autonomous_virtual_machine API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleHistoryId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}/content" + required_arguments = ['autonomousVirtualMachineId'] + resource_path = "/autonomousVirtualMachines/{autonomousVirtualMachineId}" method = "GET" - operation_name = "get_console_history_content" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/GetConsoleHistoryContent" + operation_name = "get_autonomous_virtual_machine" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVirtualMachine/GetAutonomousVirtualMachine" # Don't accept unknown kwargs expected_kwargs = [ @@ -17508,11 +17707,10 @@ def get_console_history_content(self, db_node_id, console_history_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_console_history_content got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_virtual_machine got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleHistoryId": console_history_id + "autonomousVirtualMachineId": autonomous_virtual_machine_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17522,7 +17720,7 @@ def get_console_history_content(self, db_node_id, console_history_id, **kwargs): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { - "accept": "application/octet-stream", + "accept": "application/json", "content-type": "application/json", "opc-request-id": kwargs.get("opc_request_id", missing) } @@ -17543,7 +17741,7 @@ def get_console_history_content(self, db_node_id, console_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="stream", + response_type="AutonomousVirtualMachine", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17554,26 +17752,24 @@ def get_console_history_content(self, db_node_id, console_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="stream", + response_type="AutonomousVirtualMachine", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_data_guard_association(self, database_id, data_guard_association_id, **kwargs): + def get_autonomous_vm_cluster(self, autonomous_vm_cluster_id, **kwargs): """ - Gets the specified Data Guard association's configuration information. + Gets information about the specified Autonomous VM cluster for an Exadata Cloud@Customer system. To get information about an Autonomous VM Cluster in the Oracle cloud, see :func:`get_cloud_autonomous_vm_cluster`. - :param str 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 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. @@ -17587,28 +17783,32 @@ def get_data_guard_association(self, database_id, data_guard_association_id, **k allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousVmCluster` :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_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'dataGuardAssociationId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "GET" - operation_name = "get_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/GetDataGuardAssociation" + operation_name = "get_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/GetAutonomousVmCluster" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_data_guard_association got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17619,8 +17819,10 @@ def get_data_guard_association(self, database_id, data_guard_association_id, **k 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -17637,7 +17839,7 @@ 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="AutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17648,22 +17850,25 @@ 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="AutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_database(self, database_id, **kwargs): + def get_autonomous_vm_cluster_resource_usage(self, autonomous_vm_cluster_id, **kwargs): """ - Gets information about the specified database. + Get the resource usage details for the specified Autonomous Exadata VM cluster. - :param str 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 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. @@ -17676,27 +17881,32 @@ def get_database(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousVmClusterResourceUsage` :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_vm_cluster_resource_usage API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/resourceUsage" method = "GET" - operation_name = "get_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/GetDatabase" + operation_name = "get_autonomous_vm_cluster_resource_usage" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/GetAutonomousVmClusterResourceUsage" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_database got unknown kwargs: {extra_kwargs!r}") + f"get_autonomous_vm_cluster_resource_usage got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17707,8 +17917,10 @@ def get_database(self, database_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -17725,7 +17937,7 @@ def get_database(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", + response_type="AutonomousVmClusterResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17736,19 +17948,19 @@ def get_database(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", + response_type="AutonomousVmClusterResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_database_software_image(self, database_software_image_id, **kwargs): + def get_backup(self, backup_id, **kwargs): """ - Gets information about the specified database software image. + Gets information about the specified backup. - :param str database_software_image_id: (required) - The DB system `OCID`__. + :param str backup_id: (required) + The backup `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -17764,27 +17976,27 @@ def get_database_software_image(self, database_software_image_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Backup` :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_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseSoftwareImageId'] - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + required_arguments = ['backupId'] + resource_path = "/backups/{backupId}" method = "GET" - operation_name = "get_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/GetDatabaseSoftwareImage" + operation_name = "get_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/GetBackup" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"get_backup got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseSoftwareImageId": database_software_image_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17813,7 +18025,7 @@ 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="Backup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17824,24 +18036,19 @@ 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="Backup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_id, **kwargs): + def get_backup_destination(self, backup_destination_id, **kwargs): """ - gets the upgrade history for a specified database. - - - :param str database_id: (required) - The database `OCID`__. + Gets information about the specified backup destination in an Exadata Cloud@Customer system. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str upgrade_history_entry_id: (required) - The database/db system upgrade History `OCID`__. + :param str backup_destination_id: (required) + The `OCID`__ of the backup destination. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -17860,18 +18067,18 @@ def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.BackupDestination` :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_backup_destination API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'upgradeHistoryEntryId'] - resource_path = "/databases/{databaseId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" + required_arguments = ['backupDestinationId'] + resource_path = "/backupDestinations/{backupDestinationId}" method = "GET" - operation_name = "get_database_upgrade_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseUpgradeHistoryEntry/GetDatabaseUpgradeHistoryEntry" + operation_name = "get_backup_destination" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/GetBackupDestination" # Don't accept unknown kwargs expected_kwargs = [ @@ -17882,11 +18089,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( - f"get_database_upgrade_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_backup_destination got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "upgradeHistoryEntryId": upgrade_history_entry_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17917,7 +18123,7 @@ 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="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -17928,22 +18134,25 @@ 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="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_home(self, db_home_id, **kwargs): + def get_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - Gets information about the specified Database Home. + Gets information about the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Custustomer systems, see :func:`get_autonomous_vm_cluster`. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str cloud_autonomous_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. @@ -17956,27 +18165,32 @@ def get_db_home(self, db_home_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudAutonomousVmCluster` :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_cloud_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId'] - resource_path = "/dbHomes/{dbHomeId}" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" method = "GET" - operation_name = "get_db_home" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/GetDbHome" + operation_name = "get_cloud_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/GetCloudAutonomousVmCluster" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_home got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -17987,8 +18201,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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18005,7 +18221,7 @@ def get_db_home(self, db_home_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbHome", + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18016,26 +18232,24 @@ def get_db_home(self, db_home_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbHome", + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_home_patch(self, db_home_id, patch_id, **kwargs): + def get_cloud_autonomous_vm_cluster_resource_usage(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - Gets information about a specified patch package. + Get the resource usage details for the specified Cloud Autonomous Exadata VM cluster. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str cloud_autonomous_vm_cluster_id: (required) + The Cloud 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. @@ -18049,28 +18263,32 @@ def get_db_home_patch(self, db_home_id, patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudAutonomousVmClusterResourceUsage` :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_cloud_autonomous_vm_cluster_resource_usage API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId', 'patchId'] - resource_path = "/dbHomes/{dbHomeId}/patches/{patchId}" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/resourceUsage" method = "GET" - operation_name = "get_db_home_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetDbHomePatch" + operation_name = "get_cloud_autonomous_vm_cluster_resource_usage" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/GetCloudAutonomousVmClusterResourceUsage" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_home_patch got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_autonomous_vm_cluster_resource_usage got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id, - "patchId": patch_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18081,8 +18299,10 @@ def get_db_home_patch(self, db_home_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18099,7 +18319,7 @@ def get_db_home_patch(self, db_home_id, patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Patch", + response_type="CloudAutonomousVmClusterResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18110,26 +18330,24 @@ def get_db_home_patch(self, db_home_id, patch_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Patch", + response_type="CloudAutonomousVmClusterResourceUsage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, **kwargs): + def get_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, **kwargs): """ - Gets the patch history details for the specified patchHistoryEntryId + Gets information about the specified cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud Exadata infrastructure `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. @@ -18143,28 +18361,32 @@ def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, ** allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudExadataInfrastructure` :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_cloud_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId', 'patchHistoryEntryId'] - resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries/{patchHistoryEntryId}" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "GET" - operation_name = "get_db_home_patch_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetDbHomePatchHistoryEntry" + operation_name = "get_cloud_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/GetCloudExadataInfrastructure" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_home_patch_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id, - "patchHistoryEntryId": patch_history_entry_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18175,8 +18397,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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18193,7 +18417,7 @@ 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="CloudExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18204,19 +18428,27 @@ 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="CloudExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_node(self, db_node_id, **kwargs): + def get_cloud_exadata_infrastructure_unallocated_resources(self, cloud_exadata_infrastructure_id, **kwargs): """ - Gets information about the specified database node. + Gets unallocated resources information for the specified Cloud Exadata infrastructure. - :param str db_node_id: (required) - The database node `OCID`__. + :param str cloud_exadata_infrastructure_id: (required) + The cloud 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 list[str] db_servers: (optional) + The list of `OCIDs`__ of the Db servers. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -18232,27 +18464,33 @@ def get_db_node(self, db_node_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudExadataInfrastructureUnallocatedResources` :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_cloud_exadata_infrastructure_unallocated_resources API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}/unAllocatedResources" method = "GET" - operation_name = "get_db_node" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/GetDbNode" + operation_name = "get_cloud_exadata_infrastructure_unallocated_resources" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructureUnallocatedResources/GetCloudExadataInfrastructureUnallocatedResources" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_request_id", + "db_servers" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_db_node got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_exadata_infrastructure_unallocated_resources got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id + "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18261,10 +18499,17 @@ def get_db_node(self, db_node_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "dbServers": self.base_client.generate_collection_format_param(kwargs.get("db_servers", missing), 'multi') + } + 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18280,8 +18525,9 @@ def get_db_node(self, db_node_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="DbNode", + response_type="CloudExadataInfrastructureUnallocatedResources", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18291,25 +18537,21 @@ def get_db_node(self, db_node_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="DbNode", + response_type="CloudExadataInfrastructureUnallocatedResources", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): + def get_cloud_vm_cluster(self, cloud_vm_cluster_id, **kwargs): """ - Gets information about the Exadata Db server. - - - :param str exadata_infrastructure_id: (required) - The `OCID`__ of the ExadataInfrastructure. + Gets information about the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str db_server_id: (required) - The DB server `OCID`__. + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -18328,18 +18570,18 @@ def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbServer` + :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_db_server API. + Click `here `__ to see an example of how to use get_cloud_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbServerId', 'exadataInfrastructureId'] - resource_path = "/dbServers/{dbServerId}" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "GET" - operation_name = "get_db_server" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbServer/GetDbServer" + operation_name = "get_cloud_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/GetCloudVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -18350,10 +18592,10 @@ def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_db_server got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbServerId": db_server_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18362,11 +18604,6 @@ def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - query_params = { - "exadataInfrastructureId": exadata_infrastructure_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", @@ -18388,9 +18625,8 @@ def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="DbServer", + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18400,31 +18636,27 @@ def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="DbServer", + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_system(self, db_system_id, **kwargs): + def get_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.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 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 + :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. @@ -18437,27 +18669,32 @@ def get_db_system(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataIormConfig` :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_cloud_vm_cluster_iorm_config API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" method = "GET" - operation_name = "get_db_system" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/GetDbSystem" + operation_name = "get_cloud_vm_cluster_iorm_config" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/GetCloudVmClusterIormConfig" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_system got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_vm_cluster_iorm_config got unknown kwargs: {extra_kwargs!r}") 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} @@ -18468,8 +18705,10 @@ def get_db_system(self, db_system_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18486,7 +18725,7 @@ def get_db_system(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbSystem", + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18497,27 +18736,30 @@ def get_db_system(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="DbSystem", + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_system_patch(self, db_system_id, patch_id, **kwargs): + def get_cloud_vm_cluster_update(self, cloud_vm_cluster_id, update_id, **kwargs): """ - Gets information the specified patch. + Gets information about a specified maintenance update package for a 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 - :param str patch_id: (required) - The `OCID`__ of the patch. + :param str update_id: (required) + The `OCID`__ of the maintenance update. __ 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. @@ -18530,28 +18772,33 @@ def get_db_system_patch(self, db_system_id, patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Update` :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_cloud_vm_cluster_update API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId', 'patchId'] - resource_path = "/dbSystems/{dbSystemId}/patches/{patchId}" + required_arguments = ['cloudVmClusterId', 'updateId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates/{updateId}" method = "GET" - operation_name = "get_db_system_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetDbSystemPatch" + operation_name = "get_cloud_vm_cluster_update" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Update/GetCloudVmClusterUpdate" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_system_patch got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id, - "patchId": patch_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} @@ -18562,8 +18809,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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18580,7 +18829,7 @@ 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="Update", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18591,27 +18840,30 @@ 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="Update", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id, **kwargs): + def get_cloud_vm_cluster_update_history_entry(self, cloud_vm_cluster_id, update_history_entry_id, **kwargs): """ - Gets the details of the specified patch operation on the specified DB system. + Gets the maintenance update history details for the specified update history entry. 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 - :param str patch_history_entry_id: (required) - The `OCID`__ of the patch history entry. + :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. @@ -18624,28 +18876,33 @@ def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.UpdateHistoryEntry` :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_cloud_vm_cluster_update_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId', 'patchHistoryEntryId'] - resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries/{patchHistoryEntryId}" + required_arguments = ['cloudVmClusterId', 'updateHistoryEntryId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" method = "GET" - operation_name = "get_db_system_patch_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetDbSystemPatchHistoryEntry" + operation_name = "get_cloud_vm_cluster_update_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/UpdateHistoryEntry/GetCloudVmClusterUpdateHistoryEntry" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_db_system_patch_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_cloud_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id, - "patchHistoryEntryId": patch_history_entry_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} @@ -18656,8 +18913,10 @@ def get_db_system_patch_history_entry(self, db_system_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18674,7 +18933,7 @@ 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="UpdateHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18685,29 +18944,24 @@ 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="UpdateHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entry_id, **kwargs): + def get_console_connection(self, db_node_id, console_connection_id, **kwargs): """ - Gets the details of the specified operating system upgrade operation for the specified DB system. - + Gets the specified database node console connection's information. - :param str db_system_id: (required) - The DB system `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str upgrade_history_entry_id: (required) - The database/db system upgrade History `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. @@ -18721,33 +18975,28 @@ def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entr allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbSystemUpgradeHistoryEntry` + :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_db_system_upgrade_history_entry API. + Click `here `__ to see an example of how to use get_console_connection API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId', 'upgradeHistoryEntryId'] - resource_path = "/dbSystems/{dbSystemId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" + required_arguments = ['dbNodeId', 'consoleConnectionId'] + resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" method = "GET" - operation_name = "get_db_system_upgrade_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemUpgradeHistoryEntry/GetDbSystemUpgradeHistoryEntry" + operation_name = "get_console_connection" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/GetConsoleConnection" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_db_system_upgrade_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_console_connection got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id, - "upgradeHistoryEntryId": upgrade_history_entry_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} @@ -18758,10 +19007,8 @@ def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entr 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -18778,7 +19025,7 @@ def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entr method=method, path_params=path_params, header_params=header_params, - response_type="DbSystemUpgradeHistoryEntry", + response_type="ConsoleConnection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18789,31 +19036,28 @@ def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entr method=method, path_params=path_params, header_params=header_params, - response_type="DbSystemUpgradeHistoryEntry", + response_type="ConsoleConnection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): + def get_console_history(self, db_node_id, console_history_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 database node console history. - :param str exadata_infrastructure_id: (required) - The 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 console_history_id: (required) + The OCID of the console history. + :param str opc_request_id: (optional) Unique identifier for the request. - :param list[str] excluded_fields: (optional) - If provided, the specified fields will be excluded in the response. - - Allowed values are: "multiRackConfigurationFile" - :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. @@ -18826,33 +19070,33 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ConsoleHistory` :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_console_history API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + required_arguments = ['dbNodeId', 'consoleHistoryId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" method = "GET" - operation_name = "get_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/GetExadataInfrastructure" + operation_name = "get_console_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/GetConsoleHistory" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "excluded_fields" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"get_console_history got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "dbNodeId": db_node_id, + "consoleHistoryId": console_history_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18861,19 +19105,6 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'excluded_fields' in kwargs: - excluded_fields_allowed_values = ["multiRackConfigurationFile"] - for excluded_fields_item in kwargs['excluded_fields']: - if excluded_fields_item not in excluded_fields_allowed_values: - raise ValueError( - f"Invalid value for `excluded_fields`, must be one of { excluded_fields_allowed_values }" - ) - - query_params = { - "excludedFields": self.base_client.generate_collection_format_param(kwargs.get("excluded_fields", missing), 'multi') - } - 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", @@ -18895,9 +19126,8 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="ExadataInfrastructure", + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -18907,24 +19137,26 @@ def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="ExadataInfrastructure", + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, **kwargs): + def get_console_history_content(self, db_node_id, console_history_id, **kwargs): """ - Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource. + Retrieves the specified database node console history contents upto a megabyte. - :param str autonomous_exadata_infrastructure_id: (required) - The Autonomous 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 console_history_id: (required) + The OCID of the console history. + :param str opc_request_id: (optional) Unique identifier for the request. @@ -18940,18 +19172,18 @@ def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 stream :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_console_history_content API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/ocpus" + required_arguments = ['dbNodeId', 'consoleHistoryId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}/content" method = "GET" - operation_name = "get_exadata_infrastructure_ocpus" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OCPUs/GetExadataInfrastructureOcpus" + operation_name = "get_console_history_content" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/GetConsoleHistoryContent" # Don't accept unknown kwargs expected_kwargs = [ @@ -18962,10 +19194,11 @@ 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( - f"get_exadata_infrastructure_ocpus got unknown kwargs: {extra_kwargs!r}") + f"get_console_history_content got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id + "dbNodeId": db_node_id, + "consoleHistoryId": console_history_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -18975,7 +19208,7 @@ def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { - "accept": "application/json", + "accept": "application/octet-stream", "content-type": "application/json", "opc-request-id": kwargs.get("opc_request_id", missing) } @@ -18996,7 +19229,7 @@ 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="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19007,27 +19240,24 @@ 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="stream", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructure_id, **kwargs): + def get_data_guard_association(self, database_id, data_guard_association_id, **kwargs): """ - Gets un allocated resources information for the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only. + 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 opc_request_id: (optional) - Unique identifier for the request. - - :param list[str] db_servers: (optional) - The list of `OCIDs`__ of the Db servers. + :param str data_guard_association_id: (required) + The Data Guard association's `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -19043,33 +19273,28 @@ def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructu allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructureUnAllocatedResources` + :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_exadata_infrastructure_un_allocated_resources API. + Click `here `__ to see an example of how to use get_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/unAllocatedResources" + required_arguments = ['databaseId', 'dataGuardAssociationId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" method = "GET" - operation_name = "get_exadata_infrastructure_un_allocated_resources" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructureUnAllocatedResources/GetExadataInfrastructureUnAllocatedResources" + operation_name = "get_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/GetDataGuardAssociation" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "retry_strategy", - "opc_request_id", - "db_servers" - ] + expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_exadata_infrastructure_un_allocated_resources got unknown kwargs: {extra_kwargs!r}") + f"get_data_guard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_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} @@ -19078,17 +19303,10 @@ def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructu if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - query_params = { - "dbServers": self.base_client.generate_collection_format_param(kwargs.get("db_servers", missing), 'multi') - } - 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19104,9 +19322,8 @@ def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructu resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="ExadataInfrastructureUnAllocatedResources", + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19116,38 +19333,23 @@ def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructu resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="ExadataInfrastructureUnAllocatedResources", + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadata_iorm_config(self, db_system_id, **kwargs): + def get_database(self, database_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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Gets information about the specified database. - :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 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. @@ -19160,32 +19362,27 @@ def get_exadata_iorm_config(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :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_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}" method = "GET" - operation_name = "get_exadata_iorm_config" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/GetExadataIormConfig" + operation_name = "get_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/GetDatabase" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_exadata_iorm_config got unknown kwargs: {extra_kwargs!r}") + f"get_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19196,10 +19393,8 @@ def get_exadata_iorm_config(self, db_system_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19216,7 +19411,7 @@ 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="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19227,25 +19422,22 @@ 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="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): + def get_database_software_image(self, database_software_image_id, **kwargs): """ - Gets information about the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. + Gets information about the specified database software image. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :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 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. @@ -19258,32 +19450,27 @@ def get_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` + :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_exadb_vm_cluster API. + Click `here `__ to see an example of how to use get_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}" + required_arguments = ['databaseSoftwareImageId'] + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" method = "GET" - operation_name = "get_exadb_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/GetExadbVmCluster" + operation_name = "get_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/GetDatabaseSoftwareImage" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"get_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19294,10 +19481,8 @@ def get_exadb_vm_cluster(self, exadb_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19314,7 +19499,7 @@ def get_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmCluster", + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19325,24 +19510,24 @@ def get_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmCluster", + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): + def get_database_upgrade_history_entry(self, database_id, upgrade_history_entry_id, **kwargs): """ - Gets information about a specified maintenance update package for a Exadata VM cluster on Exascale Infrastructure. + gets the upgrade history for a specified database. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :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 upgrade_history_entry_id: (required) + The database/db system upgrade History `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -19361,18 +19546,18 @@ def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmClusterUpdate` + :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 get_exadb_vm_cluster_update API. + Click `here `__ to see an example of how to use get_database_upgrade_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId', 'updateId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/updates/{updateId}" + required_arguments = ['databaseId', 'upgradeHistoryEntryId'] + resource_path = "/databases/{databaseId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" method = "GET" - operation_name = "get_exadb_vm_cluster_update" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdate/GetExadbVmClusterUpdate" + operation_name = "get_database_upgrade_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseUpgradeHistoryEntry/GetDatabaseUpgradeHistoryEntry" # Don't accept unknown kwargs expected_kwargs = [ @@ -19383,11 +19568,11 @@ def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_exadb_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") + f"get_database_upgrade_history_entry got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id, - "updateId": update_id + "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} @@ -19418,7 +19603,7 @@ def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmClusterUpdate", + response_type="DatabaseUpgradeHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19429,30 +19614,22 @@ def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmClusterUpdate", + response_type="DatabaseUpgradeHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_history_entry_id, **kwargs): + def get_db_home(self, db_home_id, **kwargs): """ - Gets the maintenance update history details for the specified update history entry. - - - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + Gets information about the specified Database Home. - __ 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. + :param str db_home_id: (required) + The Database Home `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. @@ -19465,33 +19642,27 @@ def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmClusterUpdateHistoryEntry` + :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 get_exadb_vm_cluster_update_history_entry API. + Click `here `__ to see an example of how to use get_db_home API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId', 'updateHistoryEntryId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" + required_arguments = ['dbHomeId'] + resource_path = "/dbHomes/{dbHomeId}" method = "GET" - operation_name = "get_exadb_vm_cluster_update_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdateHistoryEntry/GetExadbVmClusterUpdateHistoryEntry" + operation_name = "get_db_home" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/GetDbHome" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_exadb_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_db_home got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id, - "updateHistoryEntryId": update_history_entry_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19502,10 +19673,8 @@ def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_ 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19522,7 +19691,7 @@ def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_ method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmClusterUpdateHistoryEntry", + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19533,24 +19702,26 @@ def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_ method=method, path_params=path_params, header_params=header_params, - response_type="ExadbVmClusterUpdateHistoryEntry", + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): + def get_db_home_patch(self, db_home_id, patch_id, **kwargs): """ - Gets information about the specified Exadata Database Storage Vaults in the specified compartment. + Gets information about a specified patch package. - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :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. @@ -19564,32 +19735,28 @@ def get_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExascaleDbStorageVault` + :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_exascale_db_storage_vault API. + Click `here `__ to see an example of how to use get_db_home_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exascaleDbStorageVaultId'] - resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" + required_arguments = ['dbHomeId', 'patchId'] + resource_path = "/dbHomes/{dbHomeId}/patches/{patchId}" method = "GET" - operation_name = "get_exascale_db_storage_vault" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/GetExascaleDbStorageVault" + operation_name = "get_db_home_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetDbHomePatch" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") + f"get_db_home_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "exascaleDbStorageVaultId": exascale_db_storage_vault_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} @@ -19600,10 +19767,8 @@ def get_exascale_db_storage_vault(self, exascale_db_storage_vault_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19620,7 +19785,7 @@ def get_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExascaleDbStorageVault", + response_type="Patch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19631,23 +19796,24 @@ def get_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExascaleDbStorageVault", + response_type="Patch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_external_backup_job(self, backup_id, **kwargs): + def get_db_home_patch_history_entry(self, db_home_id, patch_history_entry_id, **kwargs): """ - Gets information about the specified external backup job. + Gets the patch history details for the specified patchHistoryEntryId - **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 db_home_id: (required) + The Database Home `OCID`__. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str backup_id: (required) - The backup `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 @@ -19663,27 +19829,28 @@ def get_external_backup_job(self, backup_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PatchHistoryEntry` :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_db_home_patch_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupId'] - resource_path = "/externalBackupJobs/{backupId}" + required_arguments = ['dbHomeId', 'patchHistoryEntryId'] + resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries/{patchHistoryEntryId}" method = "GET" - operation_name = "get_external_backup_job" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/GetExternalBackupJob" + operation_name = "get_db_home_patch_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetDbHomePatchHistoryEntry" expected_kwargs = ["retry_strategy"] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_external_backup_job got unknown kwargs: {extra_kwargs!r}") + f"get_db_home_patch_history_entry got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupId": backup_id + "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} @@ -19712,7 +19879,7 @@ def get_external_backup_job(self, backup_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExternalBackupJob", + response_type="PatchHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19723,25 +19890,22 @@ def get_external_backup_job(self, backup_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExternalBackupJob", + response_type="PatchHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_external_container_database(self, external_container_database_id, **kwargs): + def get_db_node(self, db_node_id, **kwargs): """ - Gets information about the specified external container database. + Gets information about the specified database node. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `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 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. @@ -19754,32 +19918,27 @@ def get_external_container_database(self, external_container_database_id, **kwar allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` + :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_external_container_database API. + Click `here `__ to see an example of how to use get_db_node API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}" method = "GET" - operation_name = "get_external_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/GetExternalContainerDatabase" + operation_name = "get_db_node" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/GetDbNode" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_external_container_database got unknown kwargs: {extra_kwargs!r}") + f"get_db_node got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "dbNodeId": db_node_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19790,10 +19949,8 @@ def get_external_container_database(self, external_container_database_id, **kwar 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -19810,7 +19967,7 @@ def get_external_container_database(self, external_container_database_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="ExternalContainerDatabase", + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19821,20 +19978,24 @@ def get_external_container_database(self, external_container_database_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="ExternalContainerDatabase", + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_external_database_connector(self, external_database_connector_id, **kwargs): + def get_db_server(self, exadata_infrastructure_id, db_server_id, **kwargs): """ - Gets information about the specified external database connector. + Gets information about the Exadata Db server. - :param str external_database_connector_id: (required) - The `OCID`__ of the - external database connector resource (`ExternalDatabaseConnectorId`). + :param str exadata_infrastructure_id: (required) + The `OCID`__ of the ExadataInfrastructure. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str db_server_id: (required) + The DB server `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -19853,18 +20014,18 @@ def get_external_database_connector(self, external_database_connector_id, **kwar allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.DbServer` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_external_database_connector API. + Click `here `__ to see an example of how to use get_db_server API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalDatabaseConnectorId'] - resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + required_arguments = ['dbServerId', 'exadataInfrastructureId'] + resource_path = "/dbServers/{dbServerId}" method = "GET" - operation_name = "get_external_database_connector" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/GetExternalDatabaseConnector" + operation_name = "get_db_server" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbServer/GetDbServer" # Don't accept unknown kwargs expected_kwargs = [ @@ -19875,10 +20036,10 @@ def get_external_database_connector(self, external_database_connector_id, **kwar extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_external_database_connector got unknown kwargs: {extra_kwargs!r}") + f"get_db_server got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalDatabaseConnectorId": external_database_connector_id + "dbServerId": db_server_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19887,6 +20048,11 @@ def get_external_database_connector(self, external_database_connector_id, **kwar if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "exadataInfrastructureId": exadata_infrastructure_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", @@ -19908,8 +20074,9 @@ def get_external_database_connector(self, external_database_connector_id, **kwar resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="ExternalDatabaseConnector", + response_type="DbServer", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -19919,25 +20086,30 @@ def get_external_database_connector(self, external_database_connector_id, **kwar resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="ExternalDatabaseConnector", + response_type="DbServer", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_external_non_container_database(self, external_non_container_database_id, **kwargs): + def get_db_system(self, db_system_id, **kwargs): """ - Gets information about a specific external non-container database. + Gets information about the specified DB system. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - :param str external_non_container_database_id: (required) - The external non-container 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/Content/General/Concepts/identifiers.htm + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm - :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 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. @@ -19951,32 +20123,27 @@ def get_external_non_container_database(self, external_non_container_database_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` + :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_external_non_container_database API. + Click `here `__ to see an example of how to use get_db_system API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}" method = "GET" - operation_name = "get_external_non_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/GetExternalNonContainerDatabase" + operation_name = "get_db_system" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/GetDbSystem" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_external_non_container_database got unknown kwargs: {extra_kwargs!r}") + f"get_db_system got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -19987,10 +20154,8 @@ def get_external_non_container_database(self, external_non_container_database_id 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20007,7 +20172,7 @@ def get_external_non_container_database(self, external_non_container_database_id method=method, path_params=path_params, header_params=header_params, - response_type="ExternalNonContainerDatabase", + response_type="DbSystem", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20018,25 +20183,26 @@ def get_external_non_container_database(self, external_non_container_database_id method=method, path_params=path_params, header_params=header_params, - response_type="ExternalNonContainerDatabase", + response_type="DbSystem", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_external_pluggable_database(self, external_pluggable_database_id, **kwargs): + def get_db_system_patch(self, db_system_id, patch_id, **kwargs): """ - Gets information about a specific - :func:`create_external_pluggable_database_details` resource. + Gets information the specified patch. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :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 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. @@ -20050,32 +20216,28 @@ def get_external_pluggable_database(self, external_pluggable_database_id, **kwar allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` + :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_external_pluggable_database API. + Click `here `__ to see an example of how to use get_db_system_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + required_arguments = ['dbSystemId', 'patchId'] + resource_path = "/dbSystems/{dbSystemId}/patches/{patchId}" method = "GET" - operation_name = "get_external_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/GetExternalPluggableDatabase" + operation_name = "get_db_system_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetDbSystemPatch" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"get_db_system_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "dbSystemId": db_system_id, + "patchId": patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20086,10 +20248,8 @@ def get_external_pluggable_database(self, external_pluggable_database_id, **kwar 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20106,7 +20266,7 @@ def get_external_pluggable_database(self, external_pluggable_database_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="ExternalPluggableDatabase", + response_type="Patch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20117,33 +20277,26 @@ def get_external_pluggable_database(self, external_pluggable_database_id, **kwar method=method, path_params=path_params, header_params=header_params, - response_type="ExternalPluggableDatabase", + response_type="Patch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_infrastructure_target_versions(self, compartment_id, **kwargs): + def get_db_system_patch_history_entry(self, db_system_id, patch_history_entry_id, **kwargs): """ - Gets details of the Exadata Infrastructure target system software versions that can be applied to the specified infrastructure resource for maintenance updates. - Applies to Exadata Cloud@Customer and Exadata Cloud instances only. + Gets the details of the specified patch operation on the specified DB system. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" + :param str patch_history_entry_id: (required) + The `OCID`__ of the patch history entry. - :param str opc_request_id: (optional) - Unique identifier for the request. + __ 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. @@ -20157,52 +20310,40 @@ def get_infrastructure_target_versions(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.InfrastructureTargetVersion` + :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_infrastructure_target_versions API. + Click `here `__ to see an example of how to use get_db_system_patch_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/infrastructureTargetVersions" + required_arguments = ['dbSystemId', 'patchHistoryEntryId'] + resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries/{patchHistoryEntryId}" method = "GET" - operation_name = "get_infrastructure_target_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/InfrastructureTargetVersion/GetInfrastructureTargetVersions" + operation_name = "get_db_system_patch_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetDbSystemPatchHistoryEntry" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "retry_strategy", - "target_resource_id", - "target_resource_type", - "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( - f"get_infrastructure_target_versions got unknown kwargs: {extra_kwargs!r}") - - 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] - if kwargs['target_resource_type'] not in target_resource_type_allowed_values: - raise ValueError( - f"Invalid value for `target_resource_type`, must be one of { target_resource_type_allowed_values }" - ) + f"get_db_system_patch_history_entry got unknown kwargs: {extra_kwargs!r}") - query_params = { - "compartmentId": compartment_id, - "targetResourceId": kwargs.get("target_resource_id", missing), - "targetResourceType": kwargs.get("target_resource_type", missing) + path_params = { + "dbSystemId": db_system_id, + "patchHistoryEntryId": patch_history_entry_id } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20217,9 +20358,9 @@ def get_infrastructure_target_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="InfrastructureTargetVersion", + response_type="PatchHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20228,21 +20369,26 @@ def get_infrastructure_target_versions(self, compartment_id, **kwargs): 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="InfrastructureTargetVersion", + response_type="PatchHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_key_store(self, key_store_id, **kwargs): + def get_db_system_upgrade_history_entry(self, db_system_id, upgrade_history_entry_id, **kwargs): """ - Gets information about the specified key store. + Gets the details of the specified operating system upgrade operation for the specified DB system. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str db_system_id: (required) + The DB system `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str upgrade_history_entry_id: (required) + The database/db system upgrade History `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -20261,18 +20407,18 @@ def get_key_store(self, key_store_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbSystemUpgradeHistoryEntry` :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_db_system_upgrade_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['keyStoreId'] - resource_path = "/keyStores/{keyStoreId}" + required_arguments = ['dbSystemId', 'upgradeHistoryEntryId'] + resource_path = "/dbSystems/{dbSystemId}/upgradeHistoryEntries/{upgradeHistoryEntryId}" method = "GET" - operation_name = "get_key_store" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/GetKeyStore" + operation_name = "get_db_system_upgrade_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemUpgradeHistoryEntry/GetDbSystemUpgradeHistoryEntry" # Don't accept unknown kwargs expected_kwargs = [ @@ -20283,10 +20429,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( - f"get_key_store got unknown kwargs: {extra_kwargs!r}") + f"get_db_system_upgrade_history_entry got unknown kwargs: {extra_kwargs!r}") path_params = { - "keyStoreId": key_store_id + "dbSystemId": db_system_id, + "upgradeHistoryEntryId": upgrade_history_entry_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20317,7 +20464,7 @@ def get_key_store(self, key_store_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="KeyStore", + response_type="DbSystemUpgradeHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20328,19 +20475,30 @@ def get_key_store(self, key_store_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="KeyStore", + response_type="DbSystemUpgradeHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_maintenance_run(self, maintenance_run_id, **kwargs): + def get_exadata_infrastructure(self, exadata_infrastructure_id, **kwargs): """ - Gets information about the specified maintenance run. + 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 maintenance_run_id: (required) - The maintenance run 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 list[str] excluded_fields: (optional) + If provided, the specified fields will be excluded in the response. + + Allowed values are: "multiRackConfigurationFile" :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. @@ -20354,27 +20512,33 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataInfrastructure` :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_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['maintenanceRunId'] - resource_path = "/maintenanceRuns/{maintenanceRunId}" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" method = "GET" - operation_name = "get_maintenance_run" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/GetMaintenanceRun" + operation_name = "get_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/GetExadataInfrastructure" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_request_id", + "excluded_fields" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_maintenance_run got unknown kwargs: {extra_kwargs!r}") + f"get_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "maintenanceRunId": maintenance_run_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20383,10 +20547,25 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + if 'excluded_fields' in kwargs: + excluded_fields_allowed_values = ["multiRackConfigurationFile"] + for excluded_fields_item in kwargs['excluded_fields']: + if excluded_fields_item not in excluded_fields_allowed_values: + raise ValueError( + f"Invalid value for `excluded_fields`, must be one of { excluded_fields_allowed_values }" + ) + + query_params = { + "excludedFields": self.base_client.generate_collection_format_param(kwargs.get("excluded_fields", missing), 'multi') + } + 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20402,8 +20581,9 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="MaintenanceRun", + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20413,20 +20593,26 @@ def get_maintenance_run(self, maintenance_run_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="MaintenanceRun", + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_maintenance_run_history(self, maintenance_run_history_id, **kwargs): + def get_exadata_infrastructure_ocpus(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Gets information about the specified maintenance run history. + Gets details of the available and consumed OCPUs for the specified Autonomous Exadata Infrastructure resource. - :param str maintenance_run_history_id: (required) - The maintenance run history 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 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. @@ -20440,27 +20626,32 @@ def get_maintenance_run_history(self, maintenance_run_history_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.MaintenanceRunHistory` + :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_maintenance_run_history API. + Click `here `__ to see an example of how to use get_exadata_infrastructure_ocpus API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['maintenanceRunHistoryId'] - resource_path = "/maintenanceRunHistory/{maintenanceRunHistoryId}" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/ocpus" method = "GET" - operation_name = "get_maintenance_run_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRunHistory/GetMaintenanceRunHistory" + operation_name = "get_exadata_infrastructure_ocpus" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OCPUs/GetExadataInfrastructureOcpus" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_maintenance_run_history got unknown kwargs: {extra_kwargs!r}") + f"get_exadata_infrastructure_ocpus got unknown kwargs: {extra_kwargs!r}") path_params = { - "maintenanceRunHistoryId": maintenance_run_history_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20471,8 +20662,10 @@ def get_maintenance_run_history(self, maintenance_run_history_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20489,7 +20682,7 @@ def get_maintenance_run_history(self, maintenance_run_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="MaintenanceRunHistory", + response_type="OCPUs", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20500,25 +20693,30 @@ def get_maintenance_run_history(self, maintenance_run_history_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="MaintenanceRunHistory", + response_type="OCPUs", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_oneoff_patch(self, oneoff_patch_id, **kwargs): + def get_exadata_infrastructure_un_allocated_resources(self, exadata_infrastructure_id, **kwargs): """ - Gets information about the specified one-off patch. + Gets un allocated resources information for the specified Exadata infrastructure. Applies to Exadata Cloud@Customer instances only. - :param str oneoff_patch_id: (required) - The one-off patch `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 list[str] db_servers: (optional) + The list of `OCIDs`__ of the Db servers. + + __ 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. @@ -20531,32 +20729,33 @@ def get_oneoff_patch(self, oneoff_patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OneoffPatch` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadataInfrastructureUnAllocatedResources` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_oneoff_patch API. + Click `here `__ to see an example of how to use get_exadata_infrastructure_un_allocated_resources API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['oneoffPatchId'] - resource_path = "/oneoffPatches/{oneoffPatchId}" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/unAllocatedResources" method = "GET" - operation_name = "get_oneoff_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/GetOneoffPatch" + operation_name = "get_exadata_infrastructure_un_allocated_resources" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructureUnAllocatedResources/GetExadataInfrastructureUnAllocatedResources" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id" + "opc_request_id", + "db_servers" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + f"get_exadata_infrastructure_un_allocated_resources got unknown kwargs: {extra_kwargs!r}") path_params = { - "oneoffPatchId": oneoff_patch_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20565,6 +20764,11 @@ def get_oneoff_patch(self, oneoff_patch_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "dbServers": self.base_client.generate_collection_format_param(kwargs.get("db_servers", missing), 'multi') + } + 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", @@ -20586,8 +20790,9 @@ def get_oneoff_patch(self, oneoff_patch_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="OneoffPatch", + response_type="ExadataInfrastructureUnAllocatedResources", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20597,25 +20802,32 @@ def get_oneoff_patch(self, oneoff_patch_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="OneoffPatch", + response_type="ExadataInfrastructureUnAllocatedResources", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_entry_id, **kwargs): + def get_exadata_iorm_config(self, db_system_id, **kwargs): """ - Gets the details of operations performed to convert the specified database from non-container (non-CDB) to pluggable (PDB). + 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. - :param str 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/Content/General/Concepts/identifiers.htm + 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm - :param str pdb_conversion_history_entry_id: (required) - The database conversion history `OCID`__. + + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -20634,18 +20846,18 @@ def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_e allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PdbConversionHistoryEntry` + :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_pdb_conversion_history_entry API. + Click `here `__ to see an example of how to use get_exadata_iorm_config API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'pdbConversionHistoryEntryId'] - resource_path = "/databases/{databaseId}/pdbConversionHistoryEntries/{pdbConversionHistoryEntryId}" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" method = "GET" - operation_name = "get_pdb_conversion_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PdbConversionHistoryEntry/GetPdbConversionHistoryEntry" + operation_name = "get_exadata_iorm_config" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/GetExadataIormConfig" # Don't accept unknown kwargs expected_kwargs = [ @@ -20656,11 +20868,10 @@ def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_e extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_pdb_conversion_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_exadata_iorm_config got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "pdbConversionHistoryEntryId": pdb_conversion_history_entry_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20691,7 +20902,7 @@ def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_e method=method, path_params=path_params, header_params=header_params, - response_type="PdbConversionHistoryEntry", + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20702,22 +20913,25 @@ def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_e method=method, path_params=path_params, header_params=header_params, - response_type="PdbConversionHistoryEntry", + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_pluggable_database(self, pluggable_database_id, **kwargs): + def get_exadb_vm_cluster(self, exadb_vm_cluster_id, **kwargs): """ - Gets information about the specified pluggable database. + Gets information about the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. - :param str pluggable_database_id: (required) - The database `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ 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. @@ -20730,27 +20944,32 @@ def get_pluggable_database(self, pluggable_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_pluggable_database API. + Click `here `__ to see an example of how to use get_exadb_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}" method = "GET" - operation_name = "get_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/GetPluggableDatabase" + operation_name = "get_exadb_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/GetExadbVmCluster" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"get_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20761,8 +20980,10 @@ def get_pluggable_database(self, pluggable_database_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -20779,7 +21000,7 @@ def get_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20790,19 +21011,24 @@ def get_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster(self, vm_cluster_id, **kwargs): + def get_exadb_vm_cluster_update(self, exadb_vm_cluster_id, update_id, **kwargs): """ - Gets information about the VM cluster. Applies to Exadata Cloud@Customer instances only. + Gets information about a specified maintenance update package for a Exadata VM cluster on Exascale Infrastructure. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + + __ 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 @@ -20821,18 +21047,18 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmClusterUpdate` :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_exadb_vm_cluster_update API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}" + required_arguments = ['exadbVmClusterId', 'updateId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/updates/{updateId}" method = "GET" - operation_name = "get_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/GetVmCluster" + operation_name = "get_exadb_vm_cluster_update" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdate/GetExadbVmClusterUpdate" # Don't accept unknown kwargs expected_kwargs = [ @@ -20843,10 +21069,11 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"get_exadb_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "exadbVmClusterId": exadb_vm_cluster_id, + "updateId": update_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -20877,7 +21104,7 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="VmCluster", + response_type="ExadbVmClusterUpdate", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20888,25 +21115,24 @@ def get_vm_cluster(self, vm_cluster_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="VmCluster", + response_type="ExadbVmClusterUpdate", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, **kwargs): + def get_exadb_vm_cluster_update_history_entry(self, exadb_vm_cluster_id, update_history_entry_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 maintenance update history details for the specified update history entry. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :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 @@ -20925,18 +21151,18 @@ def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_i allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmClusterUpdateHistoryEntry` :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_exadb_vm_cluster_update_history_entry API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + required_arguments = ['exadbVmClusterId', 'updateHistoryEntryId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" method = "GET" - operation_name = "get_vm_cluster_network" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/GetVmClusterNetwork" + operation_name = "get_exadb_vm_cluster_update_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdateHistoryEntry/GetExadbVmClusterUpdateHistoryEntry" # Don't accept unknown kwargs expected_kwargs = [ @@ -20947,11 +21173,11 @@ def get_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_i extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") + f"get_exadb_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "exadbVmClusterId": exadb_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} @@ -20982,7 +21208,7 @@ 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="ExadbVmClusterUpdateHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -20993,26 +21219,24 @@ 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="ExadbVmClusterUpdateHistoryEntry", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): + def get_exascale_db_storage_vault(self, exascale_db_storage_vault_id, **kwargs): """ - Gets information about a specified patch package. + Gets information about the specified Exadata Database Storage Vaults in the specified compartment. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `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. @@ -21026,28 +21250,32 @@ def get_vm_cluster_patch(self, vm_cluster_id, patch_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExascaleDbStorageVault` :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_exascale_db_storage_vault API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId', 'patchId'] - resource_path = "/vmClusters/{vmClusterId}/patches/{patchId}" + required_arguments = ['exascaleDbStorageVaultId'] + resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" method = "GET" - operation_name = "get_vm_cluster_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetVmClusterPatch" + operation_name = "get_exascale_db_storage_vault" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/GetExascaleDbStorageVault" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_vm_cluster_patch got unknown kwargs: {extra_kwargs!r}") + f"get_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id, - "patchId": patch_id + "exascaleDbStorageVaultId": exascale_db_storage_vault_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -21058,8 +21286,10 @@ def get_vm_cluster_patch(self, vm_cluster_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -21076,7 +21306,7 @@ 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="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21087,26 +21317,24 @@ 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="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_id, **kwargs): + def get_execution_action(self, execution_action_id, **kwargs): """ - Gets the patch history details for the specified patch history entry. + Gets information about the specified execution action. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str execution_action_id: (required) + The execution action `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. @@ -21120,28 +21348,32 @@ def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionAction` :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_execution_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId', 'patchHistoryEntryId'] - resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries/{patchHistoryEntryId}" + required_arguments = ['executionActionId'] + resource_path = "/executionActions/{executionActionId}" method = "GET" - operation_name = "get_vm_cluster_patch_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetVmClusterPatchHistoryEntry" + operation_name = "get_execution_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/GetExecutionAction" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( - f"get_vm_cluster_patch_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_execution_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id, - "patchHistoryEntryId": patch_history_entry_id + "executionActionId": execution_action_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -21152,8 +21384,10 @@ def get_vm_cluster_patch_history_entry(self, vm_cluster_id, patch_history_entry_ 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -21170,7 +21404,7 @@ 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="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21181,24 +21415,19 @@ 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="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): + def get_execution_window(self, execution_window_id, **kwargs): """ - Gets information about a specified maintenance update package for a VM cluster. Applies to Exadata Cloud@Customer instances only. - + Gets information about the specified execution window. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str update_id: (required) - The `OCID`__ of the maintenance update. + :param str execution_window_id: (required) + The execution window `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -21217,18 +21446,18 @@ def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterUpdate` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExecutionWindow` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_vm_cluster_update API. + Click `here `__ to see an example of how to use get_execution_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId', 'updateId'] - resource_path = "/vmClusters/{vmClusterId}/updates/{updateId}" + required_arguments = ['executionWindowId'] + resource_path = "/executionWindows/{executionWindowId}" method = "GET" - operation_name = "get_vm_cluster_update" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdate/GetVmClusterUpdate" + operation_name = "get_execution_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/GetExecutionWindow" # Don't accept unknown kwargs expected_kwargs = [ @@ -21239,11 +21468,10 @@ def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") + f"get_execution_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id, - "updateId": update_id + "executionWindowId": execution_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -21274,7 +21502,7 @@ def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterUpdate", + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21285,30 +21513,26 @@ def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterUpdate", + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entry_id, **kwargs): + def get_external_backup_job(self, backup_id, **kwargs): """ - Gets the maintenance update history details for the specified update history entry. Applies to Exadata Cloud@Customer instances only. + 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. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + __ https://docs.cloud.oracle.com/Content/Database/Tasks/mig-onprembackup.htm - __ 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. + :param str backup_id: (required) + The backup `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. @@ -21321,33 +21545,27 @@ def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entr allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterUpdateHistoryEntry` + :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_vm_cluster_update_history_entry API. + Click `here `__ to see an example of how to use get_external_backup_job API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId', 'updateHistoryEntryId'] - resource_path = "/vmClusters/{vmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" + required_arguments = ['backupId'] + resource_path = "/externalBackupJobs/{backupId}" method = "GET" - operation_name = "get_vm_cluster_update_history_entry" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdateHistoryEntry/GetVmClusterUpdateHistoryEntry" + operation_name = "get_external_backup_job" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalBackupJob/GetExternalBackupJob" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "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( - f"get_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") + f"get_external_backup_job got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id, - "updateHistoryEntryId": update_history_entry_id + "backupId": backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -21358,10 +21576,8 @@ def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entr 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -21378,7 +21594,7 @@ def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entr method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterUpdateHistoryEntry", + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21389,26 +21605,24 @@ def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entr method=method, path_params=path_params, header_params=header_params, - response_type="VmClusterUpdateHistoryEntry", + response_type="ExternalBackupJob", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_infrastructure_details, **kwargs): + def get_external_container_database(self, external_container_database_id, **kwargs): """ - **Deprecated** To create a new Autonomous Database system on dedicated Exadata Infrastructure, use the :func:`create_cloud_exadata_infrastructure` and :func:`create_cloud_autonomous_vm_cluster` operations instead. Note that to create an Autonomous VM cluster, you must have an existing Exadata Infrastructure resource to contain the VM cluster. + Gets information about the specified external container database. - :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) - **Deprecated.** Use the :func:`create_cloud_exadata_infrastructure` or :func:`create_cloud_autonomous_vm_cluster` operations instead. + :param str external_container_database_id: (required) + The ExternalContainerDatabase `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 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. @@ -21422,34 +21636,44 @@ def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_inf allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalContainerDatabase` :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_external_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousExadataInfrastructures" - method = "POST" - operation_name = "launch_autonomous_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/LaunchAutonomousExadataInfrastructure" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + method = "GET" + operation_name = "get_external_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/GetExternalContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"launch_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"get_external_container_database got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -21460,16 +21684,15 @@ def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_inf if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21478,49 +21701,27 @@ def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_inf 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="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def launch_db_system(self, launch_db_system_details, **kwargs): + def get_external_database_connector(self, external_database_connector_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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm - - - :param oci.database.models.LaunchDbSystemBase launch_db_system_details: (required) - Request to launch a DB system. + Gets information about the specified external database connector. - **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 external_database_connector_id: (required) + The `OCID`__ of the + external database connector resource (`ExternalDatabaseConnectorId`). - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + __ 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 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. @@ -21534,34 +21735,44 @@ def launch_db_system(self, launch_db_system_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 launch_db_system API. + Click `here `__ to see an example of how to use get_external_database_connector API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/dbSystems" - method = "POST" - operation_name = "launch_db_system" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/LaunchDbSystem" + required_arguments = ['externalDatabaseConnectorId'] + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + method = "GET" + operation_name = "get_external_database_connector" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/GetExternalDatabaseConnector" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"launch_db_system got unknown kwargs: {extra_kwargs!r}") + f"get_external_database_connector got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -21572,16 +21783,15 @@ def launch_db_system(self, launch_db_system_details, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) 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="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21590,56 +21800,27 @@ def launch_db_system(self, launch_db_system_details, **kwargs): 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="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_application_vips(self, compartment_id, cloud_vm_cluster_id, **kwargs): + def get_external_non_container_database(self, external_non_container_database_id, **kwargs): """ - Gets a list of application virtual IP (VIP) addresses on a cloud VM cluster. - - - :param str compartment_id: (required) - The compartment `OCID`__. + Gets information about a specific external non-container database. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str cloud_vm_cluster_id: (required) - The `OCID`__ of the cloud VM cluster associated with the application virtual IP (VIP) address. + :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 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_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 TIMECREATED is descending. - Default order for DISPLAYNAME is ascending. - The DISPLAYNAME sort order is case sensitive. - - Allowed values are: "DISPLAYNAME", "TIMECREATED" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "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. @@ -21652,66 +21833,39 @@ def list_application_vips(self, compartment_id, cloud_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ApplicationVipSummary` + :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 list_application_vips API. + Click `here `__ to see an example of how to use get_external_non_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'cloudVmClusterId'] - resource_path = "/applicationVip" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" method = "GET" - operation_name = "list_application_vips" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVipSummary/ListApplicationVips" + operation_name = "get_external_non_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/GetExternalNonContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "opc_request_id", - "sort_order", - "sort_by", - "lifecycle_state" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_application_vips got unknown kwargs: {extra_kwargs!r}") - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + f"get_external_non_container_database got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + path_params = { + "externalNonContainerDatabaseId": external_non_container_database_id + } - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { 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, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "cloudVmClusterId": cloud_vm_cluster_id, - "sortOrder": kwargs.get("sort_order", missing), - "sortBy": kwargs.get("sort_by", 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} + 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(f'Parameter {k} cannot be None, whitespace or empty string') header_params = { "accept": "application/json", @@ -21733,9 +21887,9 @@ def list_application_vips(self, compartment_id, cloud_vm_cluster_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[ApplicationVipSummary]", + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21744,29 +21898,27 @@ def list_application_vips(self, compartment_id, cloud_vm_cluster_id, **kwargs): 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[ApplicationVipSummary]", + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_container_database_dataguard_associations(self, autonomous_container_database_id, **kwargs): + def get_external_pluggable_database(self, external_pluggable_database_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 specific + :func:`create_external_pluggable_database_details` resource. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str external_pluggable_database_id: (required) + The ExternalPluggableDatabaseId `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. @@ -21780,33 +21932,32 @@ def list_autonomous_container_database_dataguard_associations(self, autonomous_c allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalPluggableDatabase` :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_external_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" method = "GET" - operation_name = "list_autonomous_container_database_dataguard_associations" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/ListAutonomousContainerDatabaseDataguardAssociations" + operation_name = "get_external_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/GetExternalPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"list_autonomous_container_database_dataguard_associations got unknown kwargs: {extra_kwargs!r}") + f"get_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -21815,16 +21966,12 @@ 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(f'Parameter {k} cannot be None, whitespace or empty string') - 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -21840,9 +21987,8 @@ 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="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21852,17 +21998,17 @@ 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="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_container_database_versions(self, compartment_id, service_component, **kwargs): + def get_infrastructure_target_versions(self, compartment_id, **kwargs): """ - Gets a list of supported Autonomous Container Database versions. + Gets details of the Exadata Infrastructure target system software versions that can be applied to the specified infrastructure resource for maintenance updates. + Applies to Exadata Cloud@Customer and Exadata Cloud instances only. :param str compartment_id: (required) @@ -21870,25 +22016,17 @@ def list_autonomous_container_database_versions(self, compartment_id, service_co __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str service_component: (required) - The service component to use, either ADBD or EXACC. - - Allowed values are: "ADBD", "EXACC" + :param str target_resource_id: (optional) + The target resource ID. - :param int limit: (optional) - The maximum number of items to return per page. + :param str target_resource_type: (optional) + The type of the target resource. - :param str page: (optional) - The pagination token to continue listing from. + Allowed values are: "AUTONOMOUS_EXADATA_INFRASTRUCTURE", "AUTONOMOUS_CONTAINER_DATABASE", "EXADATA_DB_SYSTEM", "CLOUD_EXADATA_INFRASTRUCTURE", "EXACC_INFRASTRUCTURE", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" :param str opc_request_id: (optional) Unique identifier for the request. - :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. @@ -21901,52 +22039,4328 @@ def list_autonomous_container_database_versions(self, compartment_id, service_co allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.InfrastructureTargetVersion` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_autonomous_container_database_versions API. + Click `here `__ to see an example of how to use get_infrastructure_target_versions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'serviceComponent'] - resource_path = "/autonomousContainerDatabaseVersions" + required_arguments = ['compartmentId'] + resource_path = "/infrastructureTargetVersions" method = "GET" - operation_name = "list_autonomous_container_database_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseVersionSummary/ListAutonomousContainerDatabaseVersions" + operation_name = "get_infrastructure_target_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/InfrastructureTargetVersion/GetInfrastructureTargetVersions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "opc_request_id", - "sort_order" - ] + "target_resource_id", + "target_resource_type", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_infrastructure_target_versions got unknown kwargs: {extra_kwargs!r}") + + 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] + if kwargs['target_resource_type'] not in target_resource_type_allowed_values: + raise ValueError( + f"Invalid value for `target_resource_type`, must be one of { target_resource_type_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "targetResourceId": kwargs.get("target_resource_id", missing), + "targetResourceType": kwargs.get("target_resource_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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="InfrastructureTargetVersion", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="InfrastructureTargetVersion", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['keyStoreId'] + resource_path = "/keyStores/{keyStoreId}" + method = "GET" + operation_name = "get_key_store" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/GetKeyStore" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_key_store got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="KeyStore", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['maintenanceRunId'] + resource_path = "/maintenanceRuns/{maintenanceRunId}" + method = "GET" + operation_name = "get_maintenance_run" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/GetMaintenanceRun" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_maintenance_run got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="MaintenanceRun", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_maintenance_run_history(self, maintenance_run_history_id, **kwargs): + """ + Gets information about the specified maintenance run history. + + + :param str maintenance_run_history_id: (required) + The maintenance run history 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.MaintenanceRunHistory` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_maintenance_run_history API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['maintenanceRunHistoryId'] + resource_path = "/maintenanceRunHistory/{maintenanceRunHistoryId}" + method = "GET" + operation_name = "get_maintenance_run_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRunHistory/GetMaintenanceRunHistory" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_maintenance_run_history got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "maintenanceRunHistoryId": maintenance_run_history_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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="MaintenanceRunHistory", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="MaintenanceRunHistory", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_oneoff_patch(self, oneoff_patch_id, **kwargs): + """ + Gets information about the specified one-off patch. + + + :param str oneoff_patch_id: (required) + The one-off patch `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OneoffPatch` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_oneoff_patch API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['oneoffPatchId'] + resource_path = "/oneoffPatches/{oneoffPatchId}" + method = "GET" + operation_name = "get_oneoff_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/GetOneoffPatch" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "oneoffPatchId": oneoff_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="OneoffPatch", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="OneoffPatch", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_pdb_conversion_history_entry(self, database_id, pdb_conversion_history_entry_id, **kwargs): + """ + Gets the details of operations performed to convert the specified database from non-container (non-CDB) to pluggable (PDB). + + + :param str database_id: (required) + The database `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str pdb_conversion_history_entry_id: (required) + The database conversion 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PdbConversionHistoryEntry` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_pdb_conversion_history_entry API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['databaseId', 'pdbConversionHistoryEntryId'] + resource_path = "/databases/{databaseId}/pdbConversionHistoryEntries/{pdbConversionHistoryEntryId}" + method = "GET" + operation_name = "get_pdb_conversion_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PdbConversionHistoryEntry/GetPdbConversionHistoryEntry" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_pdb_conversion_history_entry got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "databaseId": database_id, + "pdbConversionHistoryEntryId": pdb_conversion_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="PdbConversionHistoryEntry", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PdbConversionHistoryEntry", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_pluggable_database(self, pluggable_database_id, **kwargs): + """ + Gets information about the specified pluggable database. + + + :param str pluggable_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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_pluggable_database API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}" + method = "GET" + operation_name = "get_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/GetPluggableDatabase" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_pluggable_database got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "pluggableDatabaseId": 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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="PluggableDatabase", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PluggableDatabase", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_scheduled_action(self, scheduled_action_id, **kwargs): + """ + Gets information about the specified Scheduled Action. + + + :param str scheduled_action_id: (required) + The Scheduled Action `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ScheduledAction` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_scheduled_action API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['scheduledActionId'] + resource_path = "/scheduledActions/{scheduledActionId}" + method = "GET" + operation_name = "get_scheduled_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ScheduledAction/GetScheduledAction" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_scheduled_action got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "scheduledActionId": scheduled_action_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ScheduledAction", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ScheduledAction", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_scheduling_plan(self, scheduling_plan_id, **kwargs): + """ + Gets information about the specified Scheduling Plan. + + + :param str scheduling_plan_id: (required) + The Schedule Plan `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingPlan` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_scheduling_plan API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['schedulingPlanId'] + resource_path = "/schedulingPlans/{schedulingPlanId}" + method = "GET" + operation_name = "get_scheduling_plan" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/GetSchedulingPlan" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_scheduling_plan got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "schedulingPlanId": scheduling_plan_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="SchedulingPlan", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="SchedulingPlan", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_scheduling_policy(self, scheduling_policy_id, **kwargs): + """ + Gets information about the specified Scheduling Policy. + + + :param str scheduling_policy_id: (required) + The Scheduling Policy `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingPolicy` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_scheduling_policy API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}" + method = "GET" + operation_name = "get_scheduling_policy" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/GetSchedulingPolicy" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_scheduling_policy got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "schedulingPolicyId": scheduling_policy_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="SchedulingPolicy", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="SchedulingPolicy", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_scheduling_window(self, scheduling_policy_id, scheduling_window_id, **kwargs): + """ + Gets information about the specified Scheduling Window. + + + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str scheduling_window_id: (required) + The Scheduling Window `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingWindow` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_scheduling_window API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['schedulingPolicyId', 'schedulingWindowId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/schedulingWindows/{schedulingWindowId}" + method = "GET" + operation_name = "get_scheduling_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingWindow/GetSchedulingWindow" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_scheduling_window got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "schedulingPolicyId": scheduling_policy_id, + "schedulingWindowId": scheduling_window_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="SchedulingWindow", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="SchedulingWindow", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}" + method = "GET" + operation_name = "get_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/GetVmCluster" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_vm_cluster got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmCluster", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}" + method = "GET" + operation_name = "get_vm_cluster_network" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/GetVmClusterNetwork" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmClusterNetwork", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['vmClusterId', 'patchId'] + resource_path = "/vmClusters/{vmClusterId}/patches/{patchId}" + method = "GET" + operation_name = "get_vm_cluster_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/GetVmClusterPatch" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_vm_cluster_patch got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="Patch", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['vmClusterId', 'patchHistoryEntryId'] + resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries/{patchHistoryEntryId}" + method = "GET" + operation_name = "get_vm_cluster_patch_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/GetVmClusterPatchHistoryEntry" + + expected_kwargs = ["retry_strategy"] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_vm_cluster_patch_history_entry got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json" + } + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PatchHistoryEntry", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_vm_cluster_update(self, vm_cluster_id, update_id, **kwargs): + """ + Gets information about a specified maintenance update package for a 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 update_id: (required) + The `OCID`__ of the maintenance update. + + __ 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterUpdate` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster_update API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['vmClusterId', 'updateId'] + resource_path = "/vmClusters/{vmClusterId}/updates/{updateId}" + method = "GET" + operation_name = "get_vm_cluster_update" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdate/GetVmClusterUpdate" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_vm_cluster_update got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "vmClusterId": vm_cluster_id, + "updateId": update_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="VmClusterUpdate", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmClusterUpdate", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_vm_cluster_update_history_entry(self, vm_cluster_id, update_history_entry_id, **kwargs): + """ + Gets the maintenance update history details for the specified update history entry. 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 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.VmClusterUpdateHistoryEntry` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_vm_cluster_update_history_entry API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['vmClusterId', 'updateHistoryEntryId'] + resource_path = "/vmClusters/{vmClusterId}/updateHistoryEntries/{updateHistoryEntryId}" + method = "GET" + operation_name = "get_vm_cluster_update_history_entry" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdateHistoryEntry/GetVmClusterUpdateHistoryEntry" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_vm_cluster_update_history_entry got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "vmClusterId": 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} + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="VmClusterUpdateHistoryEntry", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="VmClusterUpdateHistoryEntry", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def launch_autonomous_exadata_infrastructure(self, launch_autonomous_exadata_infrastructure_details, **kwargs): + """ + **Deprecated** To create a new Autonomous Database system on dedicated Exadata Infrastructure, use the :func:`create_cloud_exadata_infrastructure` and :func:`create_cloud_autonomous_vm_cluster` operations instead. Note that to create an Autonomous VM cluster, you must have an existing Exadata Infrastructure resource to contain the VM cluster. + + + :param oci.database.models.LaunchAutonomousExadataInfrastructureDetails launch_autonomous_exadata_infrastructure_details: (required) + **Deprecated.** Use the :func:`create_cloud_exadata_infrastructure` or :func:`create_cloud_autonomous_vm_cluster` operations instead. + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/autonomousExadataInfrastructures" + method = "POST" + operation_name = "launch_autonomous_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/LaunchAutonomousExadataInfrastructure" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"launch_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/dbSystems" + method = "POST" + operation_name = "launch_db_system" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/LaunchDbSystem" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"launch_db_system got unknown kwargs: {extra_kwargs!r}") + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_application_vips(self, compartment_id, cloud_vm_cluster_id, **kwargs): + """ + Gets a list of application virtual IP (VIP) addresses on a cloud VM cluster. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str cloud_vm_cluster_id: (required) + The `OCID`__ of the cloud VM cluster associated with the application virtual IP (VIP) address. + + __ 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_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 TIMECREATED is descending. + Default order for DISPLAYNAME is ascending. + The DISPLAYNAME sort order is case sensitive. + + Allowed values are: "DISPLAYNAME", "TIMECREATED" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ApplicationVipSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_application_vips API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId', 'cloudVmClusterId'] + resource_path = "/applicationVip" + method = "GET" + operation_name = "list_application_vips" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ApplicationVipSummary/ListApplicationVips" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "opc_request_id", + "sort_order", + "sort_by", + "lifecycle_state" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_application_vips got unknown kwargs: {extra_kwargs!r}") + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "cloudVmClusterId": cloud_vm_cluster_id, + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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} + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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[ApplicationVipSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[ApplicationVipSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations" + method = "GET" + operation_name = "list_autonomous_container_database_dataguard_associations" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/ListAutonomousContainerDatabaseDataguardAssociations" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_container_database_dataguard_associations got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_container_database_versions(self, compartment_id, service_component, **kwargs): + """ + Gets a list of supported Autonomous Container Database versions. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str service_component: (required) + The service component to use, either ADBD or EXACC. + + Allowed values are: "ADBD", "EXACC" + + :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_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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseVersionSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_container_database_versions API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId', 'serviceComponent'] + resource_path = "/autonomousContainerDatabaseVersions" + method = "GET" + operation_name = "list_autonomous_container_database_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseVersionSummary/ListAutonomousContainerDatabaseVersions" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "opc_request_id", + "sort_order" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_container_database_versions got unknown kwargs: {extra_kwargs!r}") + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + service_component_allowed_values = ["ADBD", "EXACC"] + if service_component not in service_component_allowed_values: + raise ValueError( + f"Invalid value for `service_component`, must be one of { service_component_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "serviceComponent": service_component + } + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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[AutonomousContainerDatabaseVersionSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousContainerDatabaseVersionSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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", "ENABLING_AUTONOMOUS_DATA_GUARD", "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 str cloud_autonomous_vm_cluster_id: (optional) + The cloud Autonomous VM Cluster `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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/autonomousContainerDatabases" + method = "GET" + operation_name = "list_autonomous_container_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ListAutonomousContainerDatabases" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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", + "cloud_autonomous_vm_cluster_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_container_databases got unknown kwargs: {extra_kwargs!r}") + + 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( + f"Invalid value for `infrastructure_type`, must be one of { 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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", "ENABLING_AUTONOMOUS_DATA_GUARD", "UNAVAILABLE"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { 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), + "cloudAutonomousVmClusterId": kwargs.get("cloud_autonomous_vm_cluster_id", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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", "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 type: (optional) + A filter to return only backups that matches with the given type of Backup. + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/autonomousDatabaseBackups" + method = "GET" + operation_name = "list_autonomous_database_backups" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/ListAutonomousDatabaseBackups" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "autonomous_database_id", + "compartment_id", + "limit", + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name", + "type", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_database_backups got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { 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), + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_database_character_sets(self, **kwargs): + """ + Gets a list of supported character sets. + + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :param bool is_shared: (optional) + Specifies whether this request is for an Autonomous Database Serverless instance. By default, this request will be for Autonomous Database on Dedicated Exadata Infrastructure. + + :param bool is_dedicated: (optional) + Specifies if the request is for an Autonomous Database Dedicated instance. The default request is for an Autonomous Database Dedicated instance. + + :param str character_set_type: (optional) + Specifies whether this request pertains to database character sets or national character sets. + + Allowed values are: "DATABASE", "NATIONAL" + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseCharacterSets` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_character_sets API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/autonomousDatabaseCharacterSets" + method = "GET" + operation_name = "list_autonomous_database_character_sets" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseCharacterSets/ListAutonomousDatabaseCharacterSets" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_request_id", + "is_shared", + "is_dedicated", + "character_set_type" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_database_character_sets got unknown kwargs: {extra_kwargs!r}") + + if 'character_set_type' in kwargs: + character_set_type_allowed_values = ["DATABASE", "NATIONAL"] + if kwargs['character_set_type'] not in character_set_type_allowed_values: + raise ValueError( + f"Invalid value for `character_set_type`, must be one of { character_set_type_allowed_values }" + ) + + query_params = { + "isShared": kwargs.get("is_shared", missing), + "isDedicated": kwargs.get("is_dedicated", missing), + "characterSetType": kwargs.get("character_set_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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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[AutonomousDatabaseCharacterSets]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousDatabaseCharacterSets]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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", "INACCESSIBLE", "STANDBY" + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId', 'compartmentId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/clones" + method = "GET" + operation_name = "list_autonomous_database_clones" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabaseClones" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_autonomous_database_clones got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { 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", "INACCESSIBLE", "STANDBY"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `clone_type`, must be one of { 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations" + method = "GET" + operation_name = "list_autonomous_database_dataguard_associations" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseDataguardAssociation/ListAutonomousDatabaseDataguardAssociations" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_database_dataguard_associations got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_database_peers(self, autonomous_database_id, **kwargs): + """ + Lists the Autonomous Database peers for the specified Autonomous Database. + + + :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 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabasePeerCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_peers API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/peers" + method = "GET" + operation_name = "list_autonomous_database_peers" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabasePeers" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"list_autonomous_database_peers got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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", + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="AutonomousDatabasePeerCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="AutonomousDatabasePeerCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_database_refreshable_clones(self, autonomous_database_id, **kwargs): + """ + Lists the OCIDs of the Autonomous Database local and connected remote refreshable clones with the region where they exist for the specified source database. + + + :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 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.RefreshableCloneCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_refreshable_clones API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/refreshableClones" + method = "GET" + operation_name = "list_autonomous_database_refreshable_clones" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabaseRefreshableClones" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"list_autonomous_database_refreshable_clones got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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", + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="RefreshableCloneCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="RefreshableCloneCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_database_software_images(self, compartment_id, image_shape_family, **kwargs): + """ + Gets a list of the Autonomous 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 str image_shape_family: (required) + A filter to return only resources that match the given image shape family exactly. + + Allowed values are: "EXACC_SHAPE", "EXADATA_SHAPE" + + :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 sort_by: (optional) + parameter according to which Autonomous Database Software Images will be sorted. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "AVAILABLE", "FAILED", "PROVISIONING", "EXPIRED", "TERMINATED", "TERMINATING", "UPDATING" + + :param str opc_request_id: (optional) + Unique identifier for the request. + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseSoftwareImageCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_database_software_images API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId', 'imageShapeFamily'] + resource_path = "/autonomousDatabaseSoftwareImages" + method = "GET" + operation_name = "list_autonomous_database_software_images" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/ListAutonomousDatabaseSoftwareImages" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "sort_order", + "sort_by", + "lifecycle_state", + "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( + f"list_autonomous_database_software_images got unknown kwargs: {extra_kwargs!r}") + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["AVAILABLE", "FAILED", "PROVISIONING", "EXPIRED", "TERMINATED", "TERMINATING", "UPDATING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + image_shape_family_allowed_values = ["EXACC_SHAPE", "EXADATA_SHAPE"] + if image_shape_family not in image_shape_family_allowed_values: + raise ValueError( + f"Invalid value for `image_shape_family`, must be one of { image_shape_family_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing), + "imageShapeFamily": image_shape_family + } + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="AutonomousDatabaseSoftwareImageCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="AutonomousDatabaseSoftwareImageCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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", "INACCESSIBLE", "STANDBY" + + :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 bool is_resource_pool_leader: (optional) + Filter if the resource is the resource pool leader. A value of `true` returns only resource pool leader. + + :param str resource_pool_leader_id: (optional) + The database `OCID`__ of the resourcepool Leader Autonomous Database. + + __ 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/autonomousDatabases" + method = "GET" + operation_name = "list_autonomous_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabases" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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", + "is_resource_pool_leader", + "resource_pool_leader_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_databases got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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( + f"Invalid value for `infrastructure_type`, must be one of { 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", "INACCESSIBLE", "STANDBY"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { 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( + f"Invalid value for `db_workload`, must be one of { 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), + "isResourcePoolLeader": kwargs.get("is_resource_pool_leader", missing), + "resourcePoolLeaderId": kwargs.get("resource_pool_leader_id", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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 + Autonomous Database Serverless (https://docs.oracle.com/en/cloud/paas/autonomous-database/index.html) databases. + + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/autonomousDbPreviewVersions" + method = "GET" + operation_name = "list_autonomous_db_preview_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDbPreviewVersionSummary/ListAutonomousDbPreviewVersions" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_autonomous_db_preview_versions got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DBWORKLOAD"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/autonomousDbVersions" + method = "GET" + operation_name = "list_autonomous_db_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDbVersionSummary/ListAutonomousDbVersions" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_autonomous_db_versions got unknown kwargs: {extra_kwargs!r}") + + 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( + f"Invalid value for `db_workload`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, compartment_id, **kwargs): + """ + **Deprecated.** + + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['availabilityDomain', 'compartmentId'] + resource_path = "/autonomousExadataInfrastructureShapes" + method = "GET" + operation_name = "list_autonomous_exadata_infrastructure_shapes" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructureShapeSummary/ListAutonomousExadataInfrastructureShapes" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_autonomous_exadata_infrastructure_shapes got unknown kwargs: {extra_kwargs!r}") + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): + """ + **Deprecated.** Use the :func:`list_cloud_exadata_infrastructures` operation to list Exadata Infrastructures in the Oracle cloud and the :func:`list_cloud_autonomous_vm_clusters` operation to list Autonomous Exadata VM clusters. + + + :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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/autonomousExadataInfrastructures" + method = "GET" + operation_name = "list_autonomous_exadata_infrastructures" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/ListAutonomousExadataInfrastructures" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_autonomous_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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( + f"Invalid value for `lifecycle_state`, must be one of { 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster_id, **kwargs): + """ + Lists the Autonomous Virtual Machines in the specified Autonomous VM Cluster and Compartment. + + + :param str compartment_id: (required) + The compartment `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str autonomous_vm_cluster_id: (required) + The Autonomous Virtual machine `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 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 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousVirtualMachineSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_virtual_machines API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId', 'autonomousVmClusterId'] + resource_path = "/autonomousVirtualMachines" + method = "GET" + operation_name = "list_autonomous_virtual_machines" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVirtualMachine/ListAutonomousVirtualMachines" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "opc_request_id", + "lifecycle_state" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_autonomous_virtual_machines got unknown kwargs: {extra_kwargs!r}") + + 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( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "autonomousVmClusterId": autonomous_vm_cluster_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", 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} + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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[AutonomousVirtualMachineSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="list[AutonomousVirtualMachineSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id, **kwargs): + """ + Gets the list of resource usage details for all the Autonomous Container Database in the specified Autonomous Exadata VM cluster. + + + :param str autonomous_vm_cluster_id: (required) + The autonomous VM cluster `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 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 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseResourceUsage` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_autonomous_vm_cluster_acd_resource_usage API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/acdResourceUsage" + method = "GET" + operation_name = "list_autonomous_vm_cluster_acd_resource_usage" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ListAutonomousVmClusterAcdResourceUsage" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "compartment_id", + "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( - f"list_autonomous_container_database_versions got unknown kwargs: {extra_kwargs!r}") + f"list_autonomous_vm_cluster_acd_resource_usage got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + path_params = { + "autonomousVmClusterId": autonomous_vm_cluster_id + } - service_component_allowed_values = ["ADBD", "EXACC"] - if service_component not in service_component_allowed_values: - raise ValueError( - f"Invalid value for `service_component`, must be one of { service_component_allowed_values }" - ) + 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(f'Parameter {k} cannot be None, whitespace or empty string') query_params = { - "compartmentId": compartment_id, + "compartmentId": kwargs.get("compartment_id", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), - "serviceComponent": service_component + "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} @@ -21970,9 +26384,10 @@ def list_autonomous_container_database_versions(self, compartment_id, service_co 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[AutonomousContainerDatabaseVersionSummary]", + response_type="list[AutonomousContainerDatabaseResourceUsage]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -21981,17 +26396,18 @@ def list_autonomous_container_database_versions(self, compartment_id, service_co 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[AutonomousContainerDatabaseVersionSummary]", + response_type="list[AutonomousContainerDatabaseResourceUsage]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_container_databases(self, compartment_id, **kwargs): + def list_autonomous_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of the Autonomous Container Databases in the specified compartment. + Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment. To list Autonomous VM Clusters in the Oracle Cloud, see :func:`list_cloud_autonomous_vm_clusters`. :param str compartment_id: (required) @@ -21999,20 +26415,8 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): __ 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 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. @@ -22023,8 +26427,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) @@ -22035,21 +26437,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", "ENABLING_AUTONOMOUS_DATA_GUARD", "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 cloud_autonomous_vm_cluster_id: (optional) - The cloud Autonomous 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. @@ -22063,47 +26457,36 @@ def list_autonomous_container_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/autonomousContainerDatabases" + resource_path = "/autonomousVmClusters" method = "GET" - operation_name = "list_autonomous_container_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/ListAutonomousContainerDatabases" + operation_name = "list_autonomous_vm_clusters" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ListAutonomousVmClusters" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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", - "cloud_autonomous_vm_cluster_id" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_container_databases got unknown kwargs: {extra_kwargs!r}") - - 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( - f"Invalid value for `infrastructure_type`, must be one of { infrastructure_type_allowed_values }" - ) + f"list_autonomous_vm_clusters got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -22120,7 +26503,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", "ENABLING_AUTONOMOUS_DATA_GUARD", "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( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -22128,25 +26511,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), - "cloudAutonomousVmClusterId": kwargs.get("cloud_autonomous_vm_cluster_id", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -22163,7 +26543,7 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22174,23 +26554,18 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 @@ -22201,32 +26576,12 @@ 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. - - **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", "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 type: (optional) - A filter to return only backups that matches with the given type of Backup. - :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. @@ -22239,69 +26594,37 @@ def list_autonomous_database_backups(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.BackupDestinationSummary` :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_backup_destination API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabaseBackups" + required_arguments = ['compartmentId'] + resource_path = "/backupDestinations" method = "GET" - operation_name = "list_autonomous_database_backups" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/ListAutonomousDatabaseBackups" + operation_name = "list_backup_destination" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestinationSummary/ListBackupDestination" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "autonomous_database_id", - "compartment_id", "limit", "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "type", - "opc_request_id" + "opc_request_id", + "type" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_database_backups got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + f"list_backup_destination got unknown kwargs: {extra_kwargs!r}") query_params = { - "autonomousDatabaseId": kwargs.get("autonomous_database_id", missing), - "compartmentId": kwargs.get("compartment_id", missing), + "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), "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} @@ -22328,7 +26651,7 @@ def list_autonomous_database_backups(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseBackupSummary]", + response_type="list[BackupDestinationSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22339,30 +26662,37 @@ def list_autonomous_database_backups(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseBackupSummary]", + response_type="list[BackupDestinationSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_character_sets(self, **kwargs): + def list_backups(self, **kwargs): """ - Gets a list of supported character sets. + Gets a list of backups based on the `databaseId` or `compartmentId` specified. Either one of these query parameters must be provided. - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str database_id: (optional) + The `OCID`__ of the database. - :param bool is_shared: (optional) - Specifies whether this request is for an Autonomous Database Serverless instance. By default, this request will be for Autonomous Database on Dedicated Exadata Infrastructure. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param bool is_dedicated: (optional) - Specifies if the request is for an Autonomous Database Dedicated instance. The default request is for an Autonomous Database Dedicated instance. + :param str compartment_id: (optional) + The compartment `OCID`__. - :param str character_set_type: (optional) - Specifies whether this request pertains to database character sets or national character sets. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - Allowed values are: "DATABASE", "NATIONAL" + :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 shape_family: (optional) + If provided, filters the results to the set of database versions which are supported for the given shape family. + + Allowed values are: "SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS" :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. @@ -22376,53 +26706,54 @@ def list_autonomous_database_character_sets(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousDatabaseCharacterSets` + :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_character_sets API. + Click `here `__ to see an example of how to use list_backups API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = [] - resource_path = "/autonomousDatabaseCharacterSets" + resource_path = "/backups" method = "GET" - operation_name = "list_autonomous_database_character_sets" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseCharacterSets/ListAutonomousDatabaseCharacterSets" + operation_name = "list_backups" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/ListBackups" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "is_shared", - "is_dedicated", - "character_set_type" + "database_id", + "compartment_id", + "limit", + "page", + "shape_family" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_database_character_sets got unknown kwargs: {extra_kwargs!r}") + f"list_backups got unknown kwargs: {extra_kwargs!r}") - if 'character_set_type' in kwargs: - character_set_type_allowed_values = ["DATABASE", "NATIONAL"] - if kwargs['character_set_type'] not in character_set_type_allowed_values: + if 'shape_family' in kwargs: + shape_family_allowed_values = ["SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS"] + if kwargs['shape_family'] not in shape_family_allowed_values: raise ValueError( - f"Invalid value for `character_set_type`, must be one of { character_set_type_allowed_values }" + f"Invalid value for `shape_family`, must be one of { shape_family_allowed_values }" ) query_params = { - "isShared": kwargs.get("is_shared", missing), - "isDedicated": kwargs.get("is_dedicated", missing), - "characterSetType": kwargs.get("character_set_type", missing) + "databaseId": kwargs.get("database_id", missing), + "compartmentId": kwargs.get("compartment_id", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "shapeFamily": kwargs.get("shape_family", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -22439,7 +26770,7 @@ def list_autonomous_database_character_sets(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseCharacterSets]", + response_type="list[BackupSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22450,24 +26781,25 @@ def list_autonomous_database_character_sets(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseCharacterSets]", + response_type="list[BackupSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_clones(self, compartment_id, autonomous_database_id, **kwargs): + def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - Lists the Autonomous Database clones for the specified Autonomous Database. + Gets the list of resource usage details for all the Cloud Autonomous Container Database + in the specified Cloud Autonomous Exadata VM cluster. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str cloud_autonomous_vm_cluster_id: (required) + The Cloud VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str compartment_id: (optional) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -22480,31 +26812,6 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id :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", "INACCESSIBLE", "STANDBY" - - :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. @@ -22517,39 +26824,35 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabaseResourceUsage` :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_autonomous_vm_cluster_acd_resource_usage API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId', 'compartmentId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/clones" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/acdResourceUsage" method = "GET" - operation_name = "list_autonomous_database_clones" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabaseClones" + operation_name = "list_cloud_autonomous_vm_cluster_acd_resource_usage" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ListCloudAutonomousVmClusterAcdResourceUsage" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "compartment_id", "opc_request_id", "limit", - "page", - "sort_order", - "display_name", - "lifecycle_state", - "sort_by", - "clone_type" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_database_clones got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_autonomous_vm_cluster_acd_resource_usage got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -22558,43 +26861,10 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { 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", "INACCESSIBLE", "STANDBY"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { 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( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `clone_type`, must be one of { clone_type_allowed_values }" - ) - query_params = { - "compartmentId": compartment_id, + "compartmentId": kwargs.get("compartment_id", missing), "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) + "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} @@ -22621,7 +26891,7 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]", + response_type="list[AutonomousContainerDatabaseResourceUsage]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22633,28 +26903,55 @@ def list_autonomous_database_clones(self, compartment_id, autonomous_database_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]", + response_type="list[AutonomousContainerDatabaseResourceUsage]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_dataguard_associations(self, autonomous_database_id, **kwargs): + def list_cloud_autonomous_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of the Autonomous Data Guard-enabled databases associated with the specified Autonomous Database. + Lists Autonomous Exadata VM clusters in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`list_autonomous_vm_clusters`. - :param str autonomous_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 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 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", "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. @@ -22667,51 +26964,78 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudAutonomousVmClusterSummary` :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_autonomous_vm_clusters API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/autonomousDatabaseDataguardAssociations" + required_arguments = ['compartmentId'] + resource_path = "/cloudAutonomousVmClusters" method = "GET" - operation_name = "list_autonomous_database_dataguard_associations" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseDataguardAssociation/ListAutonomousDatabaseDataguardAssociations" + operation_name = "list_cloud_autonomous_vm_clusters" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ListCloudAutonomousVmClusters" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "cloud_exadata_infrastructure_id", "limit", - "page" + "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( - f"list_autonomous_database_dataguard_associations got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_autonomous_vm_clusters got unknown kwargs: {extra_kwargs!r}") - path_params = { - "autonomousDatabaseId": autonomous_database_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `lifecycle_state`, must be one of { 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) + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -22726,10 +27050,9 @@ def list_autonomous_database_dataguard_associations(self, 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[AutonomousDatabaseDataguardAssociation]", + response_type="list[CloudAutonomousVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22738,34 +27061,54 @@ def list_autonomous_database_dataguard_associations(self, autonomous_database_id 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]", + response_type="list[CloudAutonomousVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_peers(self, autonomous_database_id, **kwargs): + def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): """ - Lists the Autonomous Database peers for the specified Autonomous Database. + Gets a list of the cloud Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :param str autonomous_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 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 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: "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 cluster_placement_group_id: (optional) + A filter to return only resources that match the given cluster placement group ID 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. @@ -22778,45 +27121,67 @@ def list_autonomous_database_peers(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabasePeerCollection` + :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_peers API. + Click `here `__ to see an example of how to use list_cloud_exadata_infrastructures API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/peers" + required_arguments = ['compartmentId'] + resource_path = "/cloudExadataInfrastructures" method = "GET" - operation_name = "list_autonomous_database_peers" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabasePeers" + operation_name = "list_cloud_exadata_infrastructures" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ListCloudExadataInfrastructures" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", "limit", - "page" + "page", + "opc_request_id", + "sort_by", + "sort_order", + "lifecycle_state", + "display_name", + "cluster_placement_group_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_database_peers got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") - path_params = { - "autonomousDatabaseId": autonomous_database_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `lifecycle_state`, must be one of { 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), + "clusterPlacementGroupId": kwargs.get("cluster_placement_group_id", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -22840,10 +27205,9 @@ def list_autonomous_database_peers(self, autonomous_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="AutonomousDatabasePeerCollection", + response_type="list[CloudExadataInfrastructureSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22852,27 +27216,28 @@ def list_autonomous_database_peers(self, autonomous_database_id, **kwargs): 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="AutonomousDatabasePeerCollection", + response_type="list[CloudExadataInfrastructureSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_refreshable_clones(self, autonomous_database_id, **kwargs): + def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kwargs): """ - Lists the OCIDs of the Autonomous Database local and connected remote refreshable clones with the region where they exist for the specified source 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 opc_request_id: (optional) - Unique identifier for the request. + :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. @@ -22880,6 +27245,9 @@ def list_autonomous_database_refreshable_clones(self, autonomous_database_id, ** :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. @@ -22892,34 +27260,35 @@ def list_autonomous_database_refreshable_clones(self, autonomous_database_id, ** allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.RefreshableCloneCollection` + :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_refreshable_clones API. + Click `here `__ to see an example of how to use list_cloud_vm_cluster_update_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/refreshableClones" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries" method = "GET" - operation_name = "list_autonomous_database_refreshable_clones" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabaseRefreshableClones" + operation_name = "list_cloud_vm_cluster_update_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/UpdateHistoryEntry/ListCloudVmClusterUpdateHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", + "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( - f"list_autonomous_database_refreshable_clones got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") 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} @@ -22928,7 +27297,15 @@ def list_autonomous_database_refreshable_clones(self, autonomous_database_id, ** if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" + ) + query_params = { + "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -22957,7 +27334,7 @@ def list_autonomous_database_refreshable_clones(self, autonomous_database_id, ** path_params=path_params, query_params=query_params, header_params=header_params, - response_type="RefreshableCloneCollection", + response_type="list[UpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -22969,26 +27346,26 @@ def list_autonomous_database_refreshable_clones(self, autonomous_database_id, ** path_params=path_params, query_params=query_params, header_params=header_params, - response_type="RefreshableCloneCollection", + response_type="list[UpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_database_software_images(self, compartment_id, image_shape_family, **kwargs): + def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): """ - Gets a list of the Autonomous Database Software Images in the specified compartment. + 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 image_shape_family: (required) - A filter to return only resources that match the given image shape family exactly. + :param str update_type: (optional) + A filter to return only resources that match the given update type exactly. - Allowed values are: "EXACC_SHAPE", "EXADATA_SHAPE" + Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" :param int limit: (optional) The maximum number of items to return per page. @@ -22996,27 +27373,9 @@ def list_autonomous_database_software_images(self, compartment_id, image_shape_f :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 sort_by: (optional) - parameter according to which Autonomous Database Software Images will be sorted. - - Allowed values are: "TIMECREATED", "DISPLAYNAME" - - :param str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "AVAILABLE", "FAILED", "PROVISIONING", "EXPIRED", "TERMINATED", "TERMINATING", "UPDATING" - :param str opc_request_id: (optional) Unique identifier for the request. - :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. @@ -23029,72 +27388,54 @@ def list_autonomous_database_software_images(self, compartment_id, image_shape_f allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseSoftwareImageCollection` + :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_database_software_images API. + Click `here `__ to see an example of how to use list_cloud_vm_cluster_updates API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'imageShapeFamily'] - resource_path = "/autonomousDatabaseSoftwareImages" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates" method = "GET" - operation_name = "list_autonomous_database_software_images" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/ListAutonomousDatabaseSoftwareImages" + operation_name = "list_cloud_vm_cluster_updates" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Update/ListCloudVmClusterUpdates" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "update_type", "limit", "page", - "sort_order", - "sort_by", - "lifecycle_state", - "opc_request_id", - "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( - f"list_autonomous_database_software_images got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + path_params = { + "cloudVmClusterId": cloud_vm_cluster_id + } - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_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 = ["AVAILABLE", "FAILED", "PROVISIONING", "EXPIRED", "TERMINATED", "TERMINATING", "UPDATING"] - if kwargs['lifecycle_state'] not in 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" ) - image_shape_family_allowed_values = ["EXACC_SHAPE", "EXADATA_SHAPE"] - if image_shape_family not in image_shape_family_allowed_values: - raise ValueError( - f"Invalid value for `image_shape_family`, must be one of { image_shape_family_allowed_values }" - ) - query_params = { - "compartmentId": compartment_id, + "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), - "sortBy": kwargs.get("sort_by", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing), - "imageShapeFamily": image_shape_family + "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} @@ -23118,9 +27459,10 @@ def list_autonomous_database_software_images(self, compartment_id, image_shape_f 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="AutonomousDatabaseSoftwareImageCollection", + response_type="list[UpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23129,17 +27471,18 @@ def list_autonomous_database_software_images(self, compartment_id, image_shape_f 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="AutonomousDatabaseSoftwareImageCollection", + response_type="list[UpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_databases(self, compartment_id, **kwargs): + def list_cloud_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of Autonomous Databases based on the query parameters specified. + Gets a list of the cloud VM clusters in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. :param str compartment_id: (required) @@ -23147,10 +27490,8 @@ def list_autonomous_databases(self, compartment_id, **kwargs): __ 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 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. @@ -23161,8 +27502,6 @@ def list_autonomous_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) @@ -23170,27 +27509,10 @@ def list_autonomous_databases(self, compartment_id, **kwargs): 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", "INACCESSIBLE", "STANDBY" - - :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. + A filter to return only cloud VM clusters that match the given lifecycle state exactly. - :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. + 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. @@ -23198,21 +27520,6 @@ def list_autonomous_databases(self, compartment_id, **kwargs): :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 bool is_resource_pool_leader: (optional) - Filter if the resource is the resource pool leader. A value of `true` returns only resource pool leader. - - :param str resource_pool_leader_id: (optional) - The database `OCID`__ of the resourcepool Leader Autonomous Database. - - __ 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. @@ -23225,44 +27532,36 @@ def list_autonomous_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudVmClusterSummary` :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_clusters API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/autonomousDatabases" + resource_path = "/cloudVmClusters" method = "GET" - operation_name = "list_autonomous_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ListAutonomousDatabases" + operation_name = "list_cloud_vm_clusters" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ListCloudVmClusters" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "autonomous_container_database_id", + "cloud_exadata_infrastructure_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", - "is_resource_pool_leader", - "resource_pool_leader_id" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_databases got unknown kwargs: {extra_kwargs!r}") + f"list_cloud_vm_clusters got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -23278,44 +27577,22 @@ def list_autonomous_databases(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { 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( - f"Invalid value for `infrastructure_type`, must be one of { 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", "INACCESSIBLE", "STANDBY"] + 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( f"Invalid value for `lifecycle_state`, must be one of { 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( - f"Invalid value for `db_workload`, must be one of { db_workload_allowed_values }" - ) - query_params = { "compartmentId": compartment_id, - "autonomousContainerDatabaseId": kwargs.get("autonomous_container_database_id", missing), + "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), - "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), - "isResourcePoolLeader": kwargs.get("is_resource_pool_leader", missing), - "resourcePoolLeaderId": kwargs.get("resource_pool_leader_id", 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} @@ -23341,7 +27618,7 @@ def list_autonomous_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]", + response_type="list[CloudVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23352,44 +27629,22 @@ def list_autonomous_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousDatabaseSummary]", + response_type="list[CloudVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): + def list_console_connections(self, db_node_id, **kwargs): """ - Gets a list of supported Autonomous Database versions. Note that preview version software is only available for - Autonomous Database Serverless (https://docs.oracle.com/en/cloud/paas/autonomous-database/index.html) databases. + 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 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. @@ -23402,63 +27657,39 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ConsoleConnectionSummary` :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_console_connections API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/autonomousDbPreviewVersions" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}/consoleConnections" method = "GET" - operation_name = "list_autonomous_db_preview_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDbPreviewVersionSummary/ListAutonomousDbPreviewVersions" + operation_name = "list_console_connections" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/ListConsoleConnections" - # Don't accept unknown kwargs - expected_kwargs = [ - "allow_control_chars", - "retry_strategy", - "limit", - "page", - "opc_request_id", - "sort_by", - "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( - f"list_autonomous_db_preview_versions got unknown kwargs: {extra_kwargs!r}") + f"list_console_connections got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["DBWORKLOAD"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_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( - f"Invalid value for `sort_order`, must be one of { 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), - "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} + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -23473,9 +27704,9 @@ def list_autonomous_db_preview_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[AutonomousDbPreviewVersionSummary]", + response_type="list[ConsoleConnectionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23484,21 +27715,21 @@ def list_autonomous_db_preview_versions(self, compartment_id, **kwargs): 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[AutonomousDbPreviewVersionSummary]", + response_type="list[ConsoleConnectionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_db_versions(self, compartment_id, **kwargs): + def list_console_histories(self, db_node_id, **kwargs): """ - Gets a list of supported Autonomous Database versions. + Lists the console histories 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 @@ -23511,16 +27742,24 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): :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. + :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: "OLTP", "DW", "AJD", "APEX" + 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: "REQUESTED", "GETTING_HISTORY", "SUCCEEDED", "FAILED", "DELETED", "DELETING" + + :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. @@ -23533,18 +27772,18 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.ConsoleHistoryCollection` :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_histories API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/autonomousDbVersions" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories" method = "GET" - operation_name = "list_autonomous_db_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDbVersionSummary/ListAutonomousDbVersions" + operation_name = "list_console_histories" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/ListConsoleHistories" # Don't accept unknown kwargs expected_kwargs = [ @@ -23553,19 +27792,31 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): "limit", "page", "opc_request_id", - "db_workload", - "sort_order" + "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( - f"list_autonomous_db_versions got unknown kwargs: {extra_kwargs!r}") + f"list_console_histories got unknown kwargs: {extra_kwargs!r}") - if 'db_workload' in kwargs: - db_workload_allowed_values = ["OLTP", "DW", "AJD", "APEX"] - if kwargs['db_workload'] not in db_workload_allowed_values: + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( - f"Invalid value for `db_workload`, must be one of { db_workload_allowed_values }" + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" ) if 'sort_order' in kwargs: @@ -23575,12 +27826,20 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["REQUESTED", "GETTING_HISTORY", "SUCCEEDED", "FAILED", "DELETED", "DELETING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_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) + "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} @@ -23604,9 +27863,10 @@ def list_autonomous_db_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[AutonomousDbVersionSummary]", + response_type="ConsoleHistoryCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23615,21 +27875,24 @@ def list_autonomous_db_versions(self, compartment_id, **kwargs): 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[AutonomousDbVersionSummary]", + response_type="ConsoleHistoryCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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): """ - **Deprecated.** + 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`__. @@ -23642,8 +27905,10 @@ 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 str autonomous_patch_type: (optional) + Autonomous patch type, either \"QUARTERLY\" or \"TIMEZONE\". + + Allowed values are: "QUARTERLY", "TIMEZONE" :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. @@ -23657,18 +27922,18 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['availabilityDomain', 'compartmentId'] - resource_path = "/autonomousExadataInfrastructureShapes" + required_arguments = ['autonomousContainerDatabaseId', 'compartmentId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/patches" method = "GET" - operation_name = "list_autonomous_exadata_infrastructure_shapes" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructureShapeSummary/ListAutonomousExadataInfrastructureShapes" + operation_name = "list_container_database_patches" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousPatch/ListContainerDatabasePatches" # Don't accept unknown kwargs expected_kwargs = [ @@ -23676,27 +27941,42 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com "retry_strategy", "limit", "page", - "opc_request_id" + "autonomous_patch_type" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_exadata_infrastructure_shapes got unknown kwargs: {extra_kwargs!r}") + f"list_container_database_patches got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'autonomous_patch_type' in kwargs: + autonomous_patch_type_allowed_values = ["QUARTERLY", "TIMEZONE"] + if kwargs['autonomous_patch_type'] not in autonomous_patch_type_allowed_values: + raise ValueError( + f"Invalid value for `autonomous_patch_type`, must be one of { autonomous_patch_type_allowed_values }" + ) 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, + "autonomousPatchType": kwargs.get("autonomous_patch_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) + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -23711,9 +27991,10 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23722,21 +28003,22 @@ def list_autonomous_exadata_infrastructure_shapes(self, availability_domain, com 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): + def list_data_guard_associations(self, database_id, **kwargs): """ - **Deprecated.** Use the :func:`list_cloud_exadata_infrastructures` operation to list Exadata Infrastructures in the Oracle cloud and the :func:`list_cloud_autonomous_vm_clusters` operation to list Autonomous Exadata VM clusters. + 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 @@ -23746,29 +28028,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. @@ -23781,66 +28040,44 @@ def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/autonomousExadataInfrastructures" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations" method = "GET" - operation_name = "list_autonomous_exadata_infrastructures" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/ListAutonomousExadataInfrastructures" + operation_name = "list_data_guard_associations" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/ListDataGuardAssociations" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"list_autonomous_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") + f"list_data_guard_associations got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { 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( - f"Invalid value for `lifecycle_state`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -23862,9 +28099,10 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23873,17 +28111,18 @@ def list_autonomous_exadata_infrastructures(self, compartment_id, **kwargs): 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster_id, **kwargs): + def list_database_software_images(self, compartment_id, **kwargs): """ - Lists the Autonomous Virtual Machines in the specified Autonomous VM Cluster and Compartment. + Gets a list of the database software images in the specified compartment. :param str compartment_id: (required) @@ -23891,24 +28130,46 @@ def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str autonomous_vm_cluster_id: (required) - The Autonomous Virtual machine `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 TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. + Default order for PATCHSET is descending. + + Allowed values are: "TIMECREATED", "DISPLAYNAME", "PATCHSET" + + :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" + 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 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", "EXACC_SHAPE", "EXADBXS_SHAPE" + + :param str patch_set_greater_than_or_equal_to: (optional) + A filter to return only resources with `patchSet` greater than or equal to given value. + + :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. @@ -23922,18 +28183,18 @@ def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousVirtualMachineSummary` + :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_virtual_machines API. + Click `here `__ to see an example of how to use list_database_software_images API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'autonomousVmClusterId'] - resource_path = "/autonomousVirtualMachines" + required_arguments = ['compartmentId'] + resource_path = "/databaseSoftwareImages" method = "GET" - operation_name = "list_autonomous_virtual_machines" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVirtualMachine/ListAutonomousVirtualMachines" + operation_name = "list_database_software_images" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/ListDatabaseSoftwareImages" # Don't accept unknown kwargs expected_kwargs = [ @@ -23941,36 +28202,74 @@ def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster "retry_strategy", "limit", "page", - "opc_request_id", - "lifecycle_state" + "sort_by", + "sort_order", + "lifecycle_state", + "display_name", + "image_type", + "image_shape_family", + "patch_set_greater_than_or_equal_to", + "is_upgrade_supported" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_virtual_machines got unknown kwargs: {extra_kwargs!r}") + f"list_database_software_images got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME", "PATCHSET"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) 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( f"Invalid value for `lifecycle_state`, must be one of { 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( + f"Invalid value for `image_type`, must be one of { image_type_allowed_values }" + ) + + if 'image_shape_family' in kwargs: + image_shape_family_allowed_values = ["VM_BM_SHAPE", "EXADATA_SHAPE", "EXACC_SHAPE", "EXADBXS_SHAPE"] + if kwargs['image_shape_family'] not in image_shape_family_allowed_values: + raise ValueError( + f"Invalid value for `image_shape_family`, must be one of { image_shape_family_allowed_values }" + ) + query_params = { "compartmentId": compartment_id, - "autonomousVmClusterId": autonomous_vm_cluster_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "lifecycleState": kwargs.get("lifecycle_state", 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), + "patchSetGreaterThanOrEqualTo": kwargs.get("patch_set_greater_than_or_equal_to", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -23987,7 +28286,7 @@ def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousVirtualMachineSummary]", + response_type="list[DatabaseSoftwareImageSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -23998,26 +28297,41 @@ def list_autonomous_virtual_machines(self, compartment_id, autonomous_vm_cluster method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousVirtualMachineSummary]", + response_type="list[DatabaseSoftwareImageSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id, **kwargs): + def list_database_upgrade_history_entries(self, database_id, **kwargs): """ - Gets the list of resource usage details for all the Autonomous Container Database in the specified Autonomous Exadata VM cluster. + Gets the upgrade history for a specified database in a bare metal or virtual machine DB system. - :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 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. @@ -24040,24 +28354,27 @@ def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseResourceUsage` + :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_autonomous_vm_cluster_acd_resource_usage API. + Click `here `__ to see an example of how to use list_database_upgrade_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/acdResourceUsage" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/upgradeHistoryEntries" method = "GET" - operation_name = "list_autonomous_vm_cluster_acd_resource_usage" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ListAutonomousVmClusterAcdResourceUsage" + operation_name = "list_database_upgrade_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListDatabaseUpgradeHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "compartment_id", + "upgrade_action", + "lifecycle_state", + "sort_by", + "sort_order", "opc_request_id", "limit", "page" @@ -24065,10 +28382,10 @@ def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_vm_cluster_acd_resource_usage got unknown kwargs: {extra_kwargs!r}") + f"list_database_upgrade_history_entries got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -24077,8 +28394,39 @@ def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + if 'upgrade_action' in kwargs: + upgrade_action_allowed_values = ["PRECHECK", "UPGRADE", "ROLLBACK"] + if kwargs['upgrade_action'] not in upgrade_action_allowed_values: + raise ValueError( + f"Invalid value for `upgrade_action`, must be one of { 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( + f"Invalid value for `lifecycle_state`, must be one of { 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + query_params = { - "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) } @@ -24107,7 +28455,7 @@ def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseResourceUsage]", + response_type="list[DatabaseUpgradeHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24119,15 +28467,15 @@ def list_autonomous_vm_cluster_acd_resource_usage(self, autonomous_vm_cluster_id path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousContainerDatabaseResourceUsage]", + response_type="list[DatabaseUpgradeHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_autonomous_vm_clusters(self, compartment_id, **kwargs): + def list_databases(self, compartment_id, **kwargs): """ - Gets a list of Exadata Cloud@Customer Autonomous VM clusters in the specified compartment. To list Autonomous VM Clusters in the Oracle Cloud, see :func:`list_cloud_autonomous_vm_clusters`. + Gets a list of the databases in the specified Database Home. :param str compartment_id: (required) @@ -24135,8 +28483,15 @@ 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 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. @@ -24145,9 +28500,9 @@ def list_autonomous_vm_clusters(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 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`). @@ -24157,13 +28512,10 @@ 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" - - :param str display_name: (optional) - A filter to return only resources that match the entire display name given. The match is not case sensitive. + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "CONVERTING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED" - :param str opc_request_id: (optional) - Unique identifier for the request. + :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. @@ -24177,39 +28529,39 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DatabaseSummary` :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_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/autonomousVmClusters" + resource_path = "/databases" method = "GET" - operation_name = "list_autonomous_vm_clusters" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/ListAutonomousVmClusters" + operation_name = "list_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "exadata_infrastructure_id", + "db_home_id", + "system_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "display_name", - "opc_request_id" + "db_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_autonomous_vm_clusters got unknown kwargs: {extra_kwargs!r}") + f"list_databases got unknown kwargs: {extra_kwargs!r}") 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( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -24223,7 +28575,7 @@ 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", "UPDATING", "BACKUP_IN_PROGRESS", "UPGRADING", "CONVERTING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -24231,22 +28583,21 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "exadataInfrastructureId": kwargs.get("exadata_infrastructure_id", missing), + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -24263,7 +28614,7 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousVmClusterSummary]", + response_type="list[DatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24274,19 +28625,19 @@ def list_autonomous_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[AutonomousVmClusterSummary]", + response_type="list[DatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_backup_destination(self, compartment_id, **kwargs): + def list_db_home_patch_history_entries(self, db_home_id, **kwargs): """ - Gets a list of backup destinations in the specified compartment. + Lists the history of patch operations on the specified Database Home. - :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 @@ -24296,12 +28647,6 @@ def list_backup_destination(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 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. @@ -24314,47 +28659,51 @@ def list_backup_destination(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.BackupDestinationSummary` + :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_backup_destination API. + Click `here `__ to see an example of how to use list_db_home_patch_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/backupDestinations" + required_arguments = ['dbHomeId'] + resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries" method = "GET" - operation_name = "list_backup_destination" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestinationSummary/ListBackupDestination" + operation_name = "list_db_home_patch_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListDbHomePatchHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "limit", - "page", - "opc_request_id", - "type" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_backup_destination got unknown kwargs: {extra_kwargs!r}") + f"list_db_home_patch_history_entries got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "type": kwargs.get("type", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -24369,9 +28718,10 @@ def list_backup_destination(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[BackupDestinationSummary]", + response_type="list[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24380,26 +28730,22 @@ def list_backup_destination(self, compartment_id, **kwargs): 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[BackupDestinationSummary]", + response_type="list[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_backups(self, **kwargs): + def list_db_home_patches(self, db_home_id, **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. + Lists patches applicable to the requested Database Home. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (optional) - The compartment `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -24409,11 +28755,6 @@ def list_backups(self, **kwargs): :param str page: (optional) The pagination token to continue listing from. - :param str shape_family: (optional) - If provided, filters the results to the set of database versions which are supported for the given shape family. - - Allowed values are: "SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS" - :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. @@ -24426,47 +28767,44 @@ def list_backups(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PatchSummary` :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_db_home_patches API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/backups" + required_arguments = ['dbHomeId'] + resource_path = "/dbHomes/{dbHomeId}/patches" method = "GET" - operation_name = "list_backups" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Backup/ListBackups" + operation_name = "list_db_home_patches" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListDbHomePatches" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "database_id", - "compartment_id", "limit", - "page", - "shape_family" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_backups got unknown kwargs: {extra_kwargs!r}") + f"list_db_home_patches got unknown kwargs: {extra_kwargs!r}") - if 'shape_family' in kwargs: - shape_family_allowed_values = ["SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS"] - if kwargs['shape_family'] not in shape_family_allowed_values: - raise ValueError( - f"Invalid value for `shape_family`, must be one of { shape_family_allowed_values }" - ) + 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(f'Parameter {k} cannot be None, whitespace or empty string') query_params = { - "databaseId": kwargs.get("database_id", missing), - "compartmentId": kwargs.get("compartment_id", missing), "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "shapeFamily": kwargs.get("shape_family", 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} @@ -24488,9 +28826,10 @@ 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[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24499,32 +28838,42 @@ def list_backups(self, **kwargs): 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[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_vm_cluster_id, **kwargs): + def list_db_homes(self, compartment_id, **kwargs): """ - Gets the list of resource usage details for all the Cloud Autonomous Container Database - in the specified Cloud Autonomous Exadata VM cluster. + 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 cloud_autonomous_vm_cluster_id: (required) - The Cloud VM cluster `OCID`__. + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (optional) - The compartment `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 opc_request_id: (optional) - Unique identifier for the request. + :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 int limit: (optional) The maximum number of items to return per page. @@ -24532,6 +28881,24 @@ def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_v :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", "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. @@ -24544,56 +28911,79 @@ def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_v allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.AutonomousContainerDatabaseResourceUsage` + :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_autonomous_vm_cluster_acd_resource_usage API. + Click `here `__ to see an example of how to use list_db_homes API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/acdResourceUsage" + required_arguments = ['compartmentId'] + resource_path = "/dbHomes" method = "GET" - operation_name = "list_cloud_autonomous_vm_cluster_acd_resource_usage" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ListCloudAutonomousVmClusterAcdResourceUsage" + operation_name = "list_db_homes" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/ListDbHomes" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "compartment_id", - "opc_request_id", + "db_system_id", + "vm_cluster_id", + "backup_id", + "db_version", "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( - f"list_cloud_autonomous_vm_cluster_acd_resource_usage got unknown kwargs: {extra_kwargs!r}") + f"list_db_homes got unknown kwargs: {extra_kwargs!r}") - path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) query_params = { - "compartmentId": kwargs.get("compartment_id", missing), + "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) + "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) + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -24608,10 +28998,9 @@ def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_v 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[AutonomousContainerDatabaseResourceUsage]", + response_type="list[DbHomeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24620,18 +29009,17 @@ def list_cloud_autonomous_vm_cluster_acd_resource_usage(self, cloud_autonomous_v 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[AutonomousContainerDatabaseResourceUsage]", + response_type="list[DbHomeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_autonomous_vm_clusters(self, compartment_id, **kwargs): + def list_db_nodes(self, compartment_id, **kwargs): """ - Lists Autonomous Exadata VM clusters in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`list_autonomous_vm_clusters`. + Lists the database nodes in the specified DB system and compartment. A database node is a server running database software. :param str compartment_id: (required) @@ -24639,8 +29027,15 @@ def list_cloud_autonomous_vm_clusters(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 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 int limit: (optional) The maximum number of items to return per page. @@ -24649,9 +29044,9 @@ def list_cloud_autonomous_vm_clusters(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. + Sort by TIMECREATED. Default order for TIMECREATED is descending. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + Allowed values are: "TIMECREATED" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -24661,16 +29056,12 @@ def list_cloud_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" - - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "STOPPING", "STOPPED", "STARTING", "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 db_server_id: (optional) + The `OCID`__ of the Exacc Db server. - :param str opc_request_id: (optional) - Unique identifier for the request. + __ 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. @@ -24684,40 +29075,39 @@ def list_cloud_autonomous_vm_clusters(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.CloudAutonomousVmClusterSummary` + :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_cloud_autonomous_vm_clusters API. + Click `here `__ to see an example of how to use list_db_nodes API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/cloudAutonomousVmClusters" + resource_path = "/dbNodes" method = "GET" - operation_name = "list_cloud_autonomous_vm_clusters" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/ListCloudAutonomousVmClusters" + operation_name = "list_db_nodes" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/ListDbNodes" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "cloud_exadata_infrastructure_id", + "db_system_id", + "vm_cluster_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "availability_domain", - "display_name", - "opc_request_id" + "db_server_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_cloud_autonomous_vm_clusters got unknown kwargs: {extra_kwargs!r}") + f"list_db_nodes got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + sort_by_allowed_values = ["TIMECREATED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -24731,7 +29121,7 @@ def list_cloud_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", "UPDATING", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -24739,23 +29129,21 @@ def list_cloud_autonomous_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), "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) + "dbServerId": kwargs.get("db_server_id", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -24772,7 +29160,7 @@ def list_cloud_autonomous_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudAutonomousVmClusterSummary]", + response_type="list[DbNodeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24783,15 +29171,15 @@ def list_cloud_autonomous_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[CloudAutonomousVmClusterSummary]", + response_type="list[DbNodeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): + def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): """ - Gets a list of the cloud Exadata infrastructure resources in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Lists the Exadata DB servers in the ExadataInfrastructureId and specified compartment. :param str compartment_id: (required) @@ -24799,36 +29187,38 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str exadata_infrastructure_id: (required) + The `OCID`__ of the ExadataInfrastructure. + + __ 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_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 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`). + Sort by TIMECREATED. Default order for TIMECREATED is descending. - Allowed values are: "ASC", "DESC" + Allowed values are: "TIMECREATED" :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: "CREATING", "AVAILABLE", "UNAVAILABLE", "DELETING", "DELETED", "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 cluster_placement_group_id: (optional) - A filter to return only resources that match the given cluster placement group ID 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. @@ -24841,18 +29231,18 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbServerSummary` :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_db_servers API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/cloudExadataInfrastructures" + required_arguments = ['compartmentId', 'exadataInfrastructureId'] + resource_path = "/dbServers" method = "GET" - operation_name = "list_cloud_exadata_infrastructures" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/ListCloudExadataInfrastructures" + operation_name = "list_db_servers" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbServer/ListDbServers" # Don't accept unknown kwargs expected_kwargs = [ @@ -24860,24 +29250,16 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", + "sort_order", "opc_request_id", "sort_by", - "sort_order", "lifecycle_state", - "display_name", - "cluster_placement_group_id" + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_cloud_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_db_servers got unknown kwargs: {extra_kwargs!r}") if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -24886,8 +29268,15 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["CREATING", "AVAILABLE", "UNAVAILABLE", "DELETING", "DELETED", "MAINTENANCE_IN_PROGRESS"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -24895,13 +29284,13 @@ def list_cloud_exadata_infrastructures(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, + "exadataInfrastructureId": exadata_infrastructure_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing), - "clusterPlacementGroupId": kwargs.get("cluster_placement_group_id", 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} @@ -24927,7 +29316,7 @@ 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[DbServerSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -24938,32 +29327,19 @@ 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[DbServerSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kwargs): + def list_db_system_compute_performances(self, **kwargs): """ - Gets the history of the maintenance update actions performed on the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. - - - :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" + Gets a list of expected compute performance parameters for a virtual machine DB system based on system configuration. - :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 db_system_shape: (optional) + If provided, filters the results to the set of database versions which are supported for the given shape. :param str opc_request_id: (optional) Unique identifier for the request. @@ -24980,54 +29356,33 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbSystemComputePerformanceSummary` :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_system_compute_performances API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updateHistoryEntries" + required_arguments = [] + resource_path = "/dbSystemComputePerformance" method = "GET" - operation_name = "list_cloud_vm_cluster_update_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/UpdateHistoryEntry/ListCloudVmClusterUpdateHistoryEntries" + operation_name = "list_db_system_compute_performances" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystemComputePerformances" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "update_type", - "limit", - "page", + "db_system_shape", "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_cloud_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" - ) + f"list_db_system_compute_performances got unknown kwargs: {extra_kwargs!r}") query_params = { - "updateType": kwargs.get("update_type", missing), - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "dbSystemShape": kwargs.get("db_system_shape", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -25051,10 +29406,9 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw 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[UpdateHistoryEntrySummary]", + response_type="list[DbSystemComputePerformanceSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25063,39 +29417,30 @@ def list_cloud_vm_cluster_update_history_entries(self, cloud_vm_cluster_id, **kw 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[UpdateHistoryEntrySummary]", + response_type="list[DbSystemComputePerformanceSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): + def list_db_system_patch_history_entries(self, db_system_id, **kwargs): """ - Lists the maintenance updates that can be applied to the specified cloud VM cluster. Applies to Exadata Cloud Service instances only. + Gets the history of the patch actions performed on the specified DB system. - :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 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. @@ -25108,35 +29453,33 @@ def list_cloud_vm_cluster_updates(self, cloud_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PatchHistoryEntrySummary` :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_system_patch_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/updates" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries" method = "GET" - operation_name = "list_cloud_vm_cluster_updates" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Update/ListCloudVmClusterUpdates" + operation_name = "list_db_system_patch_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListDbSystemPatchHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"list_cloud_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") + f"list_db_system_patch_history_entries got unknown kwargs: {extra_kwargs!r}") 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} @@ -25145,15 +29488,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(f'Parameter {k} cannot be None, whitespace or empty string') - 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( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" - ) - query_params = { - "updateType": kwargs.get("update_type", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -25161,10 +29496,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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -25182,7 +29515,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[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25194,52 +29527,28 @@ 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[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_cloud_vm_clusters(self, compartment_id, **kwargs): + def list_db_system_patches(self, db_system_id, **kwargs): """ - Gets a list of the cloud VM clusters in the specified compartment. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Lists the patches applicable to the specified DB system. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ 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 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 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. @@ -25252,76 +29561,51 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PatchSummary` :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_system_patches API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/cloudVmClusters" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/patches" method = "GET" - operation_name = "list_cloud_vm_clusters" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/ListCloudVmClusters" + operation_name = "list_db_system_patches" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListDbSystemPatches" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "cloud_exadata_infrastructure_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( - f"list_cloud_vm_clusters got unknown kwargs: {extra_kwargs!r}") + f"list_db_system_patches got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + path_params = { + "dbSystemId": db_system_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { 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( - f"Invalid value for `lifecycle_state`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') 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), - "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -25336,9 +29620,10 @@ def list_cloud_vm_clusters(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[CloudVmClusterSummary]", + response_type="list[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25347,24 +29632,34 @@ def list_cloud_vm_clusters(self, compartment_id, **kwargs): 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[CloudVmClusterSummary]", + response_type="list[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_console_connections(self, db_node_id, **kwargs): + def list_db_system_shapes(self, compartment_id, **kwargs): """ - Lists the console connections for the specified database node. + 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 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 str availability_domain: (optional) + The name of the Availability Domain. + + :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. @@ -25377,34 +29672,39 @@ def list_console_connections(self, db_node_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ConsoleConnectionSummary` + :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_console_connections API. + Click `here `__ to see an example of how to use list_db_system_shapes API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}/consoleConnections" + required_arguments = ['compartmentId'] + resource_path = "/dbSystemShapes" method = "GET" - operation_name = "list_console_connections" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/ListConsoleConnections" + operation_name = "list_db_system_shapes" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemShapeSummary/ListDbSystemShapes" - expected_kwargs = ["retry_strategy"] + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "availability_domain", + "limit", + "page" + ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_console_connections got unknown kwargs: {extra_kwargs!r}") + f"list_db_system_shapes got unknown kwargs: {extra_kwargs!r}") - path_params = { - "dbNodeId": db_node_id + query_params = { + "availabilityDomain": kwargs.get("availability_domain", missing), + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) } - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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", @@ -25424,9 +29724,9 @@ def list_console_connections(self, db_node_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[ConsoleConnectionSummary]", + response_type="list[DbSystemShapeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25435,51 +29735,32 @@ def list_console_connections(self, db_node_id, **kwargs): 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[ConsoleConnectionSummary]", + response_type="list[DbSystemShapeSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_console_histories(self, db_node_id, **kwargs): + def list_db_system_storage_performances(self, storage_management, **kwargs): """ - Lists the console histories for the specified database node. - + Gets a list of possible expected storage performance parameters of a VMDB System based on Configuration. - :param str db_node_id: (required) - The database node `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str storage_management: (required) + The DB system storage management option. Used to list database versions available for that storage manager. Valid values are `ASM` and `LVM`. + * ASM specifies Oracle Automatic Storage Management + * LVM specifies logical volume manager, sometimes called logical disk manager. - :param int limit: (optional) - The maximum number of items to return per page. + Allowed values are: "ASM", "LVM" - :param str page: (optional) - The pagination token to continue listing from. + :param str shape_type: (optional) + Optional. Filters the performance results by shape type. :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: "REQUESTED", "GETTING_HISTORY", "SUCCEEDED", "FAILED", "DELETED", "DELETING" - - :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. @@ -25492,74 +29773,40 @@ def list_console_histories(self, db_node_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleHistoryCollection` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemStoragePerformanceSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_console_histories API. + Click `here `__ to see an example of how to use list_db_system_storage_performances API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories" + required_arguments = ['storageManagement'] + resource_path = "/dbSystemStoragePerformance" method = "GET" - operation_name = "list_console_histories" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/ListConsoleHistories" + operation_name = "list_db_system_storage_performances" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystemStoragePerformances" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "opc_request_id", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name" + "shape_type", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_console_histories got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + f"list_db_system_storage_performances got unknown kwargs: {extra_kwargs!r}") - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["REQUESTED", "GETTING_HISTORY", "SUCCEEDED", "FAILED", "DELETED", "DELETING"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + storage_management_allowed_values = ["ASM", "LVM"] + if storage_management not in storage_management_allowed_values: + raise ValueError( + f"Invalid value for `storage_management`, must be one of { storage_management_allowed_values }" + ) query_params = { - "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) + "storageManagement": storage_management, + "shapeType": kwargs.get("shape_type", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -25583,10 +29830,9 @@ def list_console_histories(self, db_node_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="ConsoleHistoryCollection", + response_type="list[DbSystemStoragePerformanceSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25595,27 +29841,21 @@ def list_console_histories(self, db_node_id, **kwargs): 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="ConsoleHistoryCollection", + response_type="list[DbSystemStoragePerformanceSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_container_database_patches(self, autonomous_container_database_id, compartment_id, **kwargs): + def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): """ - Lists the patches applicable to the requested container database. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + Gets the history of the upgrade actions performed on the specified DB system. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_system_id: (required) + The DB system `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -25625,10 +29865,28 @@ def list_container_database_patches(self, autonomous_container_database_id, comp :param str page: (optional) The pagination token to continue listing from. - :param str autonomous_patch_type: (optional) - Autonomous patch type, either \"QUARTERLY\" or \"TIMEZONE\". + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). - Allowed values are: "QUARTERLY", "TIMEZONE" + 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 TIMECREATED is ascending. + + Allowed values are: "TIMESTARTED" + + :param str upgrade_action: (optional) + A filter to return only upgradeHistoryEntries that match the specified Upgrade Action. + + Allowed values are: "PRECHECK", "ROLLBACK", "UPDATE_SNAPSHOT_RETENTION_DAYS", "UPGRADE" + + :param str lifecycle_state: (optional) + A filter to return only upgrade history entries that match the given lifecycle state exactly. + + Allowed values are: "IN_PROGRESS", "SUCCEEDED", "FAILED", "NEEDS_ATTENTION" + + :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. @@ -25642,18 +29900,18 @@ def list_container_database_patches(self, autonomous_container_database_id, comp allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbSystemUpgradeHistoryEntrySummary` :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_system_upgrade_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'compartmentId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/patches" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/upgradeHistoryEntries" method = "GET" - operation_name = "list_container_database_patches" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousPatch/ListContainerDatabasePatches" + operation_name = "list_db_system_upgrade_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemUpgradeHistoryEntry/ListDbSystemUpgradeHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ @@ -25661,15 +29919,19 @@ def list_container_database_patches(self, autonomous_container_database_id, comp "retry_strategy", "limit", "page", - "autonomous_patch_type" + "sort_order", + "sort_by", + "upgrade_action", + "lifecycle_state", + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_container_database_patches got unknown kwargs: {extra_kwargs!r}") + f"list_db_system_upgrade_history_entries got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -25678,25 +29940,50 @@ def list_container_database_patches(self, autonomous_container_database_id, comp if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'autonomous_patch_type' in kwargs: - autonomous_patch_type_allowed_values = ["QUARTERLY", "TIMEZONE"] - if kwargs['autonomous_patch_type'] not in autonomous_patch_type_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( - f"Invalid value for `autonomous_patch_type`, must be one of { autonomous_patch_type_allowed_values }" + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMESTARTED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + if 'upgrade_action' in kwargs: + upgrade_action_allowed_values = ["PRECHECK", "ROLLBACK", "UPDATE_SNAPSHOT_RETENTION_DAYS", "UPGRADE"] + if kwargs['upgrade_action'] not in upgrade_action_allowed_values: + raise ValueError( + f"Invalid value for `upgrade_action`, must be one of { upgrade_action_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["IN_PROGRESS", "SUCCEEDED", "FAILED", "NEEDS_ATTENTION"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) query_params = { "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "compartmentId": compartment_id, - "autonomousPatchType": kwargs.get("autonomous_patch_type", missing) + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", missing), + "upgradeAction": kwargs.get("upgrade_action", 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} 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -25714,7 +30001,7 @@ def list_container_database_patches(self, autonomous_container_database_id, comp path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousPatchSummary]", + response_type="list[DbSystemUpgradeHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25726,19 +30013,26 @@ def list_container_database_patches(self, autonomous_container_database_id, comp path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[AutonomousPatchSummary]", + response_type="list[DbSystemUpgradeHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_data_guard_associations(self, database_id, **kwargs): + def list_db_systems(self, compartment_id, **kwargs): """ - Lists all Data Guard associations for the specified database. + 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. - :param str 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + + + :param str compartment_id: (required) + The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -25748,6 +30042,34 @@ def list_data_guard_associations(self, database_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", "UPGRADING" + + :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. @@ -25760,44 +30082,68 @@ def list_data_guard_associations(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbSystemSummary` :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_systems API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations" + required_arguments = ['compartmentId'] + resource_path = "/dbSystems" method = "GET" - operation_name = "list_data_guard_associations" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/ListDataGuardAssociations" + operation_name = "list_db_systems" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystems" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "limit", - "page" + "page", + "backup_id", + "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( - f"list_data_guard_associations got unknown kwargs: {extra_kwargs!r}") + f"list_db_systems got unknown kwargs: {extra_kwargs!r}") - path_params = { - "databaseId": database_id - } + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MIGRATED", "MAINTENANCE_IN_PROGRESS", "NEEDS_ATTENTION", "UPGRADING"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) query_params = { + "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", 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) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -25819,10 +30165,9 @@ def list_data_guard_associations(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[DataGuardAssociationSummary]", + response_type="list[DbSystemSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -25831,18 +30176,17 @@ def list_data_guard_associations(self, database_id, **kwargs): 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]", + response_type="list[DbSystemSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_database_software_images(self, compartment_id, **kwargs): + def list_db_versions(self, compartment_id, **kwargs): """ - Gets a list of the database software images in the specified compartment. + Gets a list of supported Oracle Database versions. :param str compartment_id: (required) @@ -25856,41 +30200,27 @@ def list_database_software_images(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. - Default order for PATCHSET is descending. - - Allowed values are: "TIMECREATED", "DISPLAYNAME", "PATCHSET" - - :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" - - :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 image_type: (optional) - A filter to return only resources that match the given image type exactly. + :param str db_system_shape: (optional) + If provided, filters the results to the set of database versions which are supported for the given shape. - Allowed values are: "GRID_IMAGE", "DATABASE_IMAGE" + :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 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", "EXACC_SHAPE", "EXADBXS_SHAPE" + :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` and `LVM`. + * ASM specifies Oracle Automatic Storage Management + * LVM specifies logical volume manager, sometimes called logical disk manager. - :param str patch_set_greater_than_or_equal_to: (optional) - A filter to return only resources with `patchSet` greater than or equal to given value. + 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 bool is_database_software_image_supported: (optional) + If true, filters the results to the set of Oracle Database versions that are supported for OCI database software images. + :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. @@ -25903,18 +30233,18 @@ def list_database_software_images(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbVersionSummary` :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_versions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/databaseSoftwareImages" + resource_path = "/dbVersions" method = "GET" - operation_name = "list_database_software_images" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/ListDatabaseSoftwareImages" + operation_name = "list_db_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbVersionSummary/ListDbVersions" # Don't accept unknown kwargs expected_kwargs = [ @@ -25922,67 +30252,33 @@ def list_database_software_images(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "image_type", - "image_shape_family", - "patch_set_greater_than_or_equal_to", - "is_upgrade_supported" - ] - extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] - if extra_kwargs: - raise ValueError( - f"list_database_software_images got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME", "PATCHSET"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) - - 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( - f"Invalid value for `lifecycle_state`, must be one of { 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( - f"Invalid value for `image_type`, must be one of { image_type_allowed_values }" - ) + "db_system_shape", + "db_system_id", + "storage_management", + "is_upgrade_supported", + "is_database_software_image_supported" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_db_versions got unknown kwargs: {extra_kwargs!r}") - if 'image_shape_family' in kwargs: - image_shape_family_allowed_values = ["VM_BM_SHAPE", "EXADATA_SHAPE", "EXACC_SHAPE", "EXADBXS_SHAPE"] - if kwargs['image_shape_family'] not in image_shape_family_allowed_values: + if 'storage_management' in kwargs: + storage_management_allowed_values = ["ASM", "LVM"] + if kwargs['storage_management'] not in storage_management_allowed_values: raise ValueError( - f"Invalid value for `image_shape_family`, must be one of { image_shape_family_allowed_values }" + f"Invalid value for `storage_management`, must be one of { storage_management_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), - "imageType": kwargs.get("image_type", missing), - "imageShapeFamily": kwargs.get("image_shape_family", missing), - "patchSetGreaterThanOrEqualTo": kwargs.get("patch_set_greater_than_or_equal_to", missing), - "isUpgradeSupported": kwargs.get("is_upgrade_supported", 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), + "isDatabaseSoftwareImageSupported": kwargs.get("is_database_software_image_supported", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -26006,7 +30302,7 @@ def list_database_software_images(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSoftwareImageSummary]", + response_type="list[DbVersionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26017,50 +30313,54 @@ def list_database_software_images(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DatabaseSoftwareImageSummary]", + response_type="list[DbVersionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_database_upgrade_history_entries(self, database_id, **kwargs): + def list_exadata_infrastructures(self, compartment_id, **kwargs): """ - Gets the upgrade history for a specified database in a bare metal or virtual machine DB system. + 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 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 int limit: (optional) + The maximum number of items to return per page. - :param str lifecycle_state: (optional) - A filter to return only upgradeHistoryEntries that match the given lifecycle state exactly. + :param str page: (optional) + The pagination token to continue listing from. - Allowed values are: "SUCCEEDED", "FAILED", "IN_PROGRESS" + :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 ascending. + 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: "TIMESTARTED" + 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 opc_request_id: (optional) - Unique identifier for the request. + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. - :param int limit: (optional) - The maximum number of items to return per page. + Allowed values are: "CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS", "WAITING_FOR_CONNECTIVITY" - :param str page: (optional) - The pagination token to continue listing from. + :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 list[str] excluded_fields: (optional) + If provided, the specified fields will be excluded in the response. + + Allowed values are: "multiRackConfigurationFile" :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. @@ -26074,62 +30374,39 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataInfrastructureSummary` :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_exadata_infrastructures API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/upgradeHistoryEntries" + required_arguments = ['compartmentId'] + resource_path = "/exadataInfrastructures" method = "GET" - operation_name = "list_database_upgrade_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListDatabaseUpgradeHistoryEntries" + operation_name = "list_exadata_infrastructures" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/ListExadataInfrastructures" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "upgrade_action", - "lifecycle_state", + "limit", + "page", + "opc_request_id", "sort_by", "sort_order", - "opc_request_id", - "limit", - "page" + "lifecycle_state", + "display_name", + "excluded_fields" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_database_upgrade_history_entries got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - if 'upgrade_action' in kwargs: - upgrade_action_allowed_values = ["PRECHECK", "UPGRADE", "ROLLBACK"] - if kwargs['upgrade_action'] not in upgrade_action_allowed_values: - raise ValueError( - f"Invalid value for `upgrade_action`, must be one of { 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( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + f"list_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMESTARTED"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -26142,13 +30419,30 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS", "WAITING_FOR_CONNECTIVITY"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + if 'excluded_fields' in kwargs: + excluded_fields_allowed_values = ["multiRackConfigurationFile"] + for excluded_fields_item in kwargs['excluded_fields']: + if excluded_fields_item not in excluded_fields_allowed_values: + raise ValueError( + f"Invalid value for `excluded_fields`, must be one of { excluded_fields_allowed_values }" + ) + query_params = { - "upgradeAction": kwargs.get("upgrade_action", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), + "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), - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing), + "excludedFields": self.base_client.generate_collection_format_param(kwargs.get("excluded_fields", missing), 'multi') } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -26172,10 +30466,9 @@ 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[ExadataInfrastructureSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26184,34 +30477,28 @@ def list_database_upgrade_history_entries(self, database_id, **kwargs): 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[ExadataInfrastructureSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_databases(self, compartment_id, **kwargs): + def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kwargs): """ - Gets a list of the databases in the specified Database Home. - - - :param str compartment_id: (required) - The compartment `OCID`__. + Gets the history of the maintenance update actions performed on the specified Exadata VM cluster on Exascale Infrastructure. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str db_home_id: (optional) - A Database Home `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ 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 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. @@ -26219,23 +30506,8 @@ def list_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 DBNAME is ascending. The DBNAME sort order is case sensitive. - - Allowed values are: "DBNAME", "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", "BACKUP_IN_PROGRESS", "UPGRADING", "CONVERTING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED" - - :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 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. @@ -26249,75 +30521,63 @@ def list_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmClusterUpdateHistoryEntrySummary` :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_exadb_vm_cluster_update_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/databases" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/updateHistoryEntries" method = "GET" - operation_name = "list_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListDatabases" + operation_name = "list_exadb_vm_cluster_update_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdateHistoryEntry/ListExadbVmClusterUpdateHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "db_home_id", - "system_id", + "update_type", "limit", "page", - "sort_by", - "sort_order", - "lifecycle_state", - "db_name" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_databases got unknown kwargs: {extra_kwargs!r}") + f"list_exadb_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["DBNAME", "TIMECREATED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + path_params = { + "exadbVmClusterId": exadb_vm_cluster_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { 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", "BACKUP_IN_PROGRESS", "UPGRADING", "CONVERTING", "TERMINATING", "TERMINATED", "RESTORE_FAILED", "FAILED"] - if kwargs['lifecycle_state'] not in 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" ) query_params = { - "compartmentId": compartment_id, - "dbHomeId": kwargs.get("db_home_id", missing), - "systemId": kwargs.get("system_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), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "dbName": kwargs.get("db_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" + "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -26332,9 +30592,10 @@ def list_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[DatabaseSummary]", + response_type="list[ExadbVmClusterUpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26343,30 +30604,42 @@ def list_databases(self, compartment_id, **kwargs): 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[DatabaseSummary]", + response_type="list[ExadbVmClusterUpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_home_patch_history_entries(self, db_home_id, **kwargs): + def list_exadb_vm_cluster_updates(self, exadb_vm_cluster_id, **kwargs): """ - Lists the history of patch operations on the specified Database Home. + Lists the maintenance updates that can be applied to the specified Exadata VM cluster on Exascale Infrastructure. - :param str db_home_id: (required) - The Database Home `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ 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 str version: (optional) + A filter to return only resources that match the given update version exactly. + :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. @@ -26379,33 +30652,36 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmClusterUpdateSummary` :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_exadb_vm_cluster_updates API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId'] - resource_path = "/dbHomes/{dbHomeId}/patchHistoryEntries" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/updates" method = "GET" - operation_name = "list_db_home_patch_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListDbHomePatchHistoryEntries" + operation_name = "list_exadb_vm_cluster_updates" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdate/ListExadbVmClusterUpdates" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "update_type", + "version", "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( - f"list_db_home_patch_history_entries got unknown kwargs: {extra_kwargs!r}") + f"list_exadb_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -26414,7 +30690,16 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" + ) + query_params = { + "updateType": kwargs.get("update_type", missing), + "version": kwargs.get("version", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing) } @@ -26422,8 +30707,10 @@ def list_db_home_patch_history_entries(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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -26441,7 +30728,7 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]", + response_type="list[ExadbVmClusterUpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26453,19 +30740,19 @@ def list_db_home_patch_history_entries(self, db_home_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PatchHistoryEntrySummary]", + response_type="list[ExadbVmClusterUpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_home_patches(self, db_home_id, **kwargs): + def list_exadb_vm_clusters(self, compartment_id, **kwargs): """ - Lists patches applicable to the requested Database Home. + Gets a list of the Exadata VM clusters on Exascale Infrastructure in the specified compartment. Applies to Exadata Database Service on Exascale Infrastructure only. - :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 @@ -26475,6 +30762,30 @@ def list_db_home_patches(self, db_home_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: "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 Exadata VM clusters on Exascale Infrastructure that match the given lifecycle state exactly. + + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" + + :param str exascale_db_storage_vault_id: (optional) + A filter to return only Exadata VM clusters on Exascale Infrastructure that match the given Exascale Database Storage Vault ID. + + :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. @@ -26487,51 +30798,76 @@ def list_db_home_patches(self, db_home_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmClusterSummary` :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_exadb_vm_clusters API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId'] - resource_path = "/dbHomes/{dbHomeId}/patches" + required_arguments = ['compartmentId'] + resource_path = "/exadbVmClusters" method = "GET" - operation_name = "list_db_home_patches" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListDbHomePatches" + operation_name = "list_exadb_vm_clusters" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/ListExadbVmClusters" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "limit", - "page" + "page", + "sort_by", + "sort_order", + "lifecycle_state", + "exascale_db_storage_vault_id", + "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( - f"list_db_home_patches got unknown kwargs: {extra_kwargs!r}") + f"list_exadb_vm_clusters got unknown kwargs: {extra_kwargs!r}") - 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `lifecycle_state`, must be one of { 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), + "exascaleDbStorageVaultId": kwargs.get("exascale_db_storage_vault_id", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -26546,10 +30882,9 @@ 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[ExadbVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26558,18 +30893,17 @@ def list_db_home_patches(self, db_home_id, **kwargs): 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[ExadbVmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_homes(self, compartment_id, **kwargs): + def list_exascale_db_storage_vaults(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 Exadata Database Storage Vaults in the specified compartment. :param str compartment_id: (required) @@ -26577,24 +30911,6 @@ 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 int limit: (optional) The maximum number of items to return per page. @@ -26612,13 +30928,16 @@ 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 Exadata Database Storage Vaults that match the given lifecycle state exactly. 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. @@ -26631,38 +30950,35 @@ def list_db_homes(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExascaleDbStorageVaultSummary` :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_exascale_db_storage_vaults API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbHomes" + resource_path = "/exascaleDbStorageVaults" method = "GET" - operation_name = "list_db_homes" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/ListDbHomes" + operation_name = "list_exascale_db_storage_vaults" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ListExascaleDbStorageVaults" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "db_system_id", - "vm_cluster_id", - "backup_id", - "db_version", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "display_name" + "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( - f"list_db_homes got unknown kwargs: {extra_kwargs!r}") + f"list_exascale_db_storage_vaults got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] @@ -26687,10 +31003,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), @@ -26702,8 +31014,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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -26720,7 +31034,7 @@ 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[ExascaleDbStorageVaultSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26731,15 +31045,15 @@ 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[ExascaleDbStorageVaultSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_nodes(self, compartment_id, **kwargs): + def list_execution_actions(self, compartment_id, **kwargs): """ - Lists the database nodes in the specified DB system and compartment. A database node is a server running database software. + Lists the execution action resources in the specified compartment. :param str compartment_id: (required) @@ -26747,26 +31061,19 @@ 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. - - __ 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 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) - 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: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -26776,12 +31083,13 @@ def list_db_nodes(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", "STOPPING", "STOPPED", "STARTING", "TERMINATING", "TERMINATED", "FAILED" + Allowed values are: "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS" - :param str db_server_id: (optional) - The `OCID`__ of the Exacc Db server. + :param str execution_window_id: (optional) + A filter to return only resources that match the given execution wondow id. - __ 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 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. @@ -26795,39 +31103,39 @@ def list_db_nodes(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionActionSummary` :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_execution_actions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbNodes" + resource_path = "/executionActions" method = "GET" - operation_name = "list_db_nodes" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/ListDbNodes" + operation_name = "list_execution_actions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/ListExecutionActions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "db_system_id", - "vm_cluster_id", "limit", "page", + "opc_request_id", "sort_by", "sort_order", "lifecycle_state", - "db_server_id" + "execution_window_id", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_db_nodes got unknown kwargs: {extra_kwargs!r}") + f"list_execution_actions got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -26841,7 +31149,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 = ["SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -26849,21 +31157,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), "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), - "dbServerId": kwargs.get("db_server_id", missing) + "executionWindowId": kwargs.get("execution_window_id", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -26880,7 +31189,7 @@ 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[ExecutionActionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -26891,15 +31200,15 @@ 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[ExecutionActionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): + def list_execution_windows(self, compartment_id, **kwargs): """ - Lists the Exadata DB servers in the ExadataInfrastructureId and specified compartment. + Lists the execution window resources in the specified compartment. :param str compartment_id: (required) @@ -26907,34 +31216,32 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str exadata_infrastructure_id: (required) - The `OCID`__ of the ExadataInfrastructure. - - __ 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_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 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: "TIMECREATED", "DISPLAYNAME" + + :param str execution_resource_id: (optional) + A filter to return only resources that match the given resource id exactly. + + :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", "AVAILABLE", "UNAVAILABLE", "DELETING", "DELETED", "MAINTENANCE_IN_PROGRESS" + Allowed values are: "CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING" :param str display_name: (optional) A filter to return only resources that match the entire display name given. The match is not case sensitive. @@ -26951,18 +31258,18 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbServerSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExecutionWindowSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_servers API. + Click `here `__ to see an example of how to use list_execution_windows API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'exadataInfrastructureId'] - resource_path = "/dbServers" + required_arguments = ['compartmentId'] + resource_path = "/executionWindows" method = "GET" - operation_name = "list_db_servers" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbServer/ListDbServers" + operation_name = "list_execution_windows" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/ListExecutionWindows" # Don't accept unknown kwargs expected_kwargs = [ @@ -26970,16 +31277,24 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): "retry_strategy", "limit", "page", - "sort_order", "opc_request_id", "sort_by", + "execution_resource_id", + "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( - f"list_db_servers got unknown kwargs: {extra_kwargs!r}") + f"list_execution_windows got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -26988,15 +31303,8 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "AVAILABLE", "UNAVAILABLE", "DELETING", "DELETED", "MAINTENANCE_IN_PROGRESS"] + lifecycle_state_allowed_values = ["CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -27004,11 +31312,11 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): query_params = { "compartmentId": compartment_id, - "exadataInfrastructureId": exadata_infrastructure_id, "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), "sortBy": kwargs.get("sort_by", missing), + "executionResourceId": kwargs.get("execution_resource_id", missing), + "sortOrder": kwargs.get("sort_order", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), "displayName": kwargs.get("display_name", missing) } @@ -27036,7 +31344,7 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbServerSummary]", + response_type="list[ExecutionWindowSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27047,23 +31355,52 @@ def list_db_servers(self, compartment_id, exadata_infrastructure_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbServerSummary]", + response_type="list[ExecutionWindowSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_compute_performances(self, **kwargs): + def list_external_container_databases(self, compartment_id, **kwargs): """ - Gets a list of expected compute performance parameters for a virtual machine DB system based on system configuration. + Gets a list of the external container databases in the specified compartment. - :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 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. @@ -27076,33 +31413,65 @@ def list_db_system_compute_performances(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemComputePerformanceSummary` + :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_system_compute_performances API. + Click `here `__ to see an example of how to use list_external_container_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/dbSystemComputePerformance" + required_arguments = ['compartmentId'] + resource_path = "/externalcontainerdatabases" method = "GET" - operation_name = "list_db_system_compute_performances" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystemComputePerformances" + operation_name = "list_external_container_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ListExternalContainerDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "db_system_shape", - "opc_request_id" + "opc_request_id", + "limit", + "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( - f"list_db_system_compute_performances got unknown kwargs: {extra_kwargs!r}") + f"list_external_container_databases got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + 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( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) query_params = { - "dbSystemShape": kwargs.get("db_system_shape", missing) + "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} @@ -27128,7 +31497,7 @@ def list_db_system_compute_performances(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemComputePerformanceSummary]", + response_type="list[ExternalContainerDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27139,28 +31508,57 @@ def list_db_system_compute_performances(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemComputePerformanceSummary]", + response_type="list[ExternalContainerDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_patch_history_entries(self, db_system_id, **kwargs): + def list_external_database_connectors(self, compartment_id, external_database_id, **kwargs): """ - Gets the history of the patch actions performed on the specified DB system. + Gets a list of the external database connectors 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 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 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", "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. @@ -27173,51 +31571,75 @@ def list_db_system_patch_history_entries(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalDatabaseConnectorSummary` :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_database_connectors API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/patchHistoryEntries" + required_arguments = ['compartmentId', 'externalDatabaseId'] + resource_path = "/externaldatabaseconnectors" method = "GET" - operation_name = "list_db_system_patch_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListDbSystemPatchHistoryEntries" + operation_name = "list_external_database_connectors" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/ListExternalDatabaseConnectors" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"list_db_system_patch_history_entries got unknown kwargs: {extra_kwargs!r}") + f"list_external_database_connectors got unknown kwargs: {extra_kwargs!r}") - 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) query_params = { + "compartmentId": compartment_id, + "externalDatabaseId": external_database_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -27232,10 +31654,9 @@ 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[ExternalDatabaseConnectorSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27244,31 +31665,54 @@ def list_db_system_patch_history_entries(self, db_system_id, **kwargs): 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[ExternalDatabaseConnectorSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_patches(self, db_system_id, **kwargs): + def list_external_non_container_databases(self, compartment_id, **kwargs): """ - Lists the patches applicable to 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. @@ -27281,51 +31725,74 @@ def list_db_system_patches(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalNonContainerDatabaseSummary` :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_non_container_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/patches" + required_arguments = ['compartmentId'] + resource_path = "/externalnoncontainerdatabases" method = "GET" - operation_name = "list_db_system_patches" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListDbSystemPatches" + operation_name = "list_external_non_container_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/ListExternalNonContainerDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"list_db_system_patches got unknown kwargs: {extra_kwargs!r}") + f"list_external_non_container_databases got unknown kwargs: {extra_kwargs!r}") - 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( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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( + f"Invalid value for `lifecycle_state`, must be one of { 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -27340,10 +31807,9 @@ 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[ExternalNonContainerDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27352,18 +31818,18 @@ def list_db_system_patches(self, db_system_id, **kwargs): 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[ExternalNonContainerDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_shapes(self, compartment_id, **kwargs): + def list_external_pluggable_databases(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 :func:`create_external_pluggable_database_details` + resources in the specified compartment. :param str compartment_id: (required) @@ -27371,8 +31837,13 @@ 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 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 :param int limit: (optional) The maximum number of items to return per page. @@ -27380,6 +31851,27 @@ def list_db_system_shapes(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. + + 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. @@ -27392,44 +31884,76 @@ def list_db_system_shapes(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 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_shapes API. + Click `here `__ to see an example of how to use list_external_pluggable_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbSystemShapes" + resource_path = "/externalpluggabledatabases" method = "GET" - operation_name = "list_db_system_shapes" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemShapeSummary/ListDbSystemShapes" + operation_name = "list_external_pluggable_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/ListExternalPluggableDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "availability_domain", + "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( - f"list_db_system_shapes got unknown kwargs: {extra_kwargs!r}") + f"list_external_pluggable_databases got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + 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( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) query_params = { - "availabilityDomain": kwargs.get("availability_domain", missing), "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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -27446,7 +31970,7 @@ 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="list[ExternalPluggableDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27457,29 +31981,40 @@ 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="list[ExternalPluggableDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_storage_performances(self, storage_management, **kwargs): + def list_flex_components(self, compartment_id, **kwargs): """ - Gets a list of possible expected storage performance parameters of a VMDB System based on Configuration. + 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 storage_management: (required) - The DB system storage management option. Used to list database versions available for that storage manager. Valid values are `ASM` and `LVM`. - * ASM specifies Oracle Automatic Storage Management - * LVM specifies logical volume manager, sometimes called logical disk manager. + :param str compartment_id: (required) + The compartment `OCID`__. - Allowed values are: "ASM", "LVM" + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str shape_type: (optional) - Optional. Filters the performance results by shape type. + :param str name: (optional) + A filter to return only resources that match the entire name given. The match is not case sensitive. - :param str opc_request_id: (optional) - Unique identifier for the request. + :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. + + :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. @@ -27493,49 +32028,62 @@ def list_db_system_storage_performances(self, storage_management, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemStoragePerformanceSummary` + :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_storage_performances API. + Click `here `__ to see an example of how to use list_flex_components API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['storageManagement'] - resource_path = "/dbSystemStoragePerformance" + required_arguments = ['compartmentId'] + resource_path = "/dbSystemShapes/flexComponents" method = "GET" - operation_name = "list_db_system_storage_performances" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystemStoragePerformances" + operation_name = "list_flex_components" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/FlexComponentCollection/ListFlexComponents" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "shape_type", - "opc_request_id" + "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( - f"list_db_system_storage_performances got unknown kwargs: {extra_kwargs!r}") + f"list_flex_components got unknown kwargs: {extra_kwargs!r}") - storage_management_allowed_values = ["ASM", "LVM"] - if storage_management not in storage_management_allowed_values: - raise ValueError( - f"Invalid value for `storage_management`, must be one of { storage_management_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( + f"Invalid value for `sort_order`, must be one of { 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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) query_params = { - "storageManagement": storage_management, - "shapeType": kwargs.get("shape_type", 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) } 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -27552,7 +32100,7 @@ def list_db_system_storage_performances(self, storage_management, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemStoragePerformanceSummary]", + response_type="FlexComponentCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27563,50 +32111,57 @@ def list_db_system_storage_performances(self, storage_management, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[DbSystemStoragePerformanceSummary]", + response_type="FlexComponentCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): + def list_gi_version_minor_versions(self, version, **kwargs): """ - Gets the history of the upgrade actions performed on the specified DB system. + Gets a list of supported Oracle Grid Infrastructure minor versions for the given major version and shape family. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str version: (required) + The Oracle Grid Infrastructure major version. + + :param str availability_domain: (optional) + The target availability domain. Only passed if the limit is AD-specific. + + :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 str shape_family: (optional) + If provided, filters the results to the set of database versions which are supported for the given shape family. - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). + Allowed values are: "SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS" - Allowed values are: "ASC", "DESC" + :param bool is_gi_version_for_provisioning: (optional) + If true, returns the Grid Infrastructure versions that can be used for provisioning a cluster - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is ascending. + :param str shape: (optional) + If provided, filters the results for the given shape. - Allowed values are: "TIMESTARTED" + :param str sort_by: (optional) + Sort by VERSION. Default order for VERSION is descending. - :param str upgrade_action: (optional) - A filter to return only upgradeHistoryEntries that match the specified Upgrade Action. + Allowed values are: "VERSION" - Allowed values are: "PRECHECK", "ROLLBACK", "UPDATE_SNAPSHOT_RETENTION_DAYS", "UPGRADE" + :param str sort_order: (optional) + The sort order to use, either ascending (`ASC`) or descending (`DESC`). - :param str lifecycle_state: (optional) - A filter to return only upgrade history entries that match the given lifecycle state exactly. + Allowed values are: "ASC", "DESC" - Allowed values are: "IN_PROGRESS", "SUCCEEDED", "FAILED", "NEEDS_ATTENTION" + :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. @@ -27620,38 +32175,41 @@ def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.DbSystemUpgradeHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.GiMinorVersionSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_db_system_upgrade_history_entries API. + Click `here `__ to see an example of how to use list_gi_version_minor_versions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/upgradeHistoryEntries" + required_arguments = ['version'] + resource_path = "/giVersions/{version}/minorVersions" method = "GET" - operation_name = "list_db_system_upgrade_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystemUpgradeHistoryEntry/ListDbSystemUpgradeHistoryEntries" + operation_name = "list_gi_version_minor_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/GiMinorVersionSummary/ListGiVersionMinorVersions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "sort_order", + "availability_domain", + "compartment_id", + "opc_request_id", + "shape_family", + "is_gi_version_for_provisioning", + "shape", "sort_by", - "upgrade_action", - "lifecycle_state", - "opc_request_id" + "sort_order", + "limit", + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_db_system_upgrade_history_entries got unknown kwargs: {extra_kwargs!r}") + f"list_gi_version_minor_versions got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id + "version": version } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -27660,41 +32218,37 @@ def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: + if 'shape_family' in kwargs: + shape_family_allowed_values = ["SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS"] + if kwargs['shape_family'] not in shape_family_allowed_values: raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + f"Invalid value for `shape_family`, must be one of { shape_family_allowed_values }" ) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMESTARTED"] + sort_by_allowed_values = ["VERSION"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" ) - if 'upgrade_action' in kwargs: - upgrade_action_allowed_values = ["PRECHECK", "ROLLBACK", "UPDATE_SNAPSHOT_RETENTION_DAYS", "UPGRADE"] - if kwargs['upgrade_action'] not in upgrade_action_allowed_values: - raise ValueError( - f"Invalid value for `upgrade_action`, must be one of { upgrade_action_allowed_values }" - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["IN_PROGRESS", "SUCCEEDED", "FAILED", "NEEDS_ATTENTION"] - if kwargs['lifecycle_state'] not in lifecycle_state_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( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) query_params = { - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), + "availabilityDomain": kwargs.get("availability_domain", missing), + "compartmentId": kwargs.get("compartment_id", missing), + "shapeFamily": kwargs.get("shape_family", missing), + "isGiVersionForProvisioning": kwargs.get("is_gi_version_for_provisioning", missing), + "shape": kwargs.get("shape", missing), "sortBy": kwargs.get("sort_by", missing), - "upgradeAction": kwargs.get("upgrade_action", missing), - "lifecycleState": kwargs.get("lifecycle_state", 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} @@ -27721,7 +32275,7 @@ def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DbSystemUpgradeHistoryEntrySummary]", + response_type="list[GiMinorVersionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27733,22 +32287,15 @@ def list_db_system_upgrade_history_entries(self, db_system_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[DbSystemUpgradeHistoryEntrySummary]", + response_type="list[GiMinorVersionSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Gets a list of supported GI versions. :param str compartment_id: (required) @@ -27762,33 +32309,16 @@ 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", "UPGRADING" + :param str shape: (optional) + If provided, filters the results for the given shape. :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. + The target availability domain. Only passed if the limit is AD-specific. :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. @@ -27802,18 +32332,18 @@ def list_db_systems(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbSystems" + resource_path = "/giVersions" method = "GET" - operation_name = "list_db_systems" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/ListDbSystems" + operation_name = "list_gi_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/GiVersionSummary/ListGiVersions" # Don't accept unknown kwargs expected_kwargs = [ @@ -27821,24 +32351,14 @@ 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", + "availability_domain" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_db_systems got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_gi_versions got unknown kwargs: {extra_kwargs!r}") if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -27847,23 +32367,13 @@ def list_db_systems(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { 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", "UPGRADING"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { 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), + "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} @@ -27887,7 +32397,7 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -27898,15 +32408,15 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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) @@ -27920,26 +32430,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` and `LVM`. - * ASM specifies Oracle Automatic Storage Management - * LVM specifies logical volume manager, sometimes called logical disk manager. - - 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 bool is_database_software_image_supported: (optional) - If true, filters the results to the set of Oracle Database versions that are supported for OCI database software images. + :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. @@ -27953,18 +32445,18 @@ def list_db_versions(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbVersions" + resource_path = "/keyStores" method = "GET" - operation_name = "list_db_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbVersionSummary/ListDbVersions" + operation_name = "list_key_stores" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStoreSummary/ListKeyStores" # Don't accept unknown kwargs expected_kwargs = [ @@ -27972,40 +32464,26 @@ def list_db_versions(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", - "db_system_shape", - "db_system_id", - "storage_management", - "is_upgrade_supported", - "is_database_software_image_supported" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_db_versions got unknown kwargs: {extra_kwargs!r}") - - if 'storage_management' in kwargs: - storage_management_allowed_values = ["ASM", "LVM"] - if kwargs['storage_management'] not in storage_management_allowed_values: - raise ValueError( - f"Invalid value for `storage_management`, must be one of { storage_management_allowed_values }" - ) + f"list_key_stores got unknown kwargs: {extra_kwargs!r}") 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), - "isDatabaseSoftwareImageSupported": kwargs.get("is_database_software_image_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -28022,7 +32500,7 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28033,16 +32511,15 @@ 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]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_exadata_infrastructures(self, compartment_id, **kwargs): + def list_maintenance_run_history(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 run histories in the specified compartment. :param str compartment_id: (required) @@ -28050,19 +32527,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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" + + :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`). @@ -28070,17 +32559,17 @@ def list_exadata_infrastructures(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. + The state of the maintenance run history. - Allowed values are: "CREATING", "REQUIRES_ACTIVATION", "ACTIVATING", "ACTIVE", "ACTIVATION_FAILED", "FAILED", "UPDATING", "DELETING", "DELETED", "DISCONNECTED", "MAINTENANCE_IN_PROGRESS", "WAITING_FOR_CONNECTIVITY" + Allowed values are: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED" - :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 list[str] excluded_fields: (optional) - If provided, the specified fields will be excluded in the response. + :param str maintenance_subtype: (optional) + The sub-type of the maintenance run. - Allowed values are: "multiRackConfigurationFile" + Allowed values are: "QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE" :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. @@ -28094,39 +32583,55 @@ def list_exadata_infrastructures(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.MaintenanceRunHistorySummary` :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_run_history API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/exadataInfrastructures" + resource_path = "/maintenanceRunHistory" method = "GET" - operation_name = "list_exadata_infrastructures" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/ListExadataInfrastructures" + operation_name = "list_maintenance_run_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRunHistory/ListMaintenanceRunHistory" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "target_resource_id", + "target_resource_type", + "maintenance_type", "limit", "page", - "opc_request_id", "sort_by", "sort_order", "lifecycle_state", - "display_name", - "excluded_fields" + "availability_domain", + "maintenance_subtype" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_exadata_infrastructures got unknown kwargs: {extra_kwargs!r}") + f"list_maintenance_run_history got unknown kwargs: {extra_kwargs!r}") + + 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] + if kwargs['target_resource_type'] not in target_resource_type_allowed_values: + raise ValueError( + f"Invalid value for `target_resource_type`, must be one of { 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( + f"Invalid value for `maintenance_type`, must be one of { 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( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -28140,38 +32645,38 @@ 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", "WAITING_FOR_CONNECTIVITY"] + lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) - if 'excluded_fields' in kwargs: - excluded_fields_allowed_values = ["multiRackConfigurationFile"] - for excluded_fields_item in kwargs['excluded_fields']: - if excluded_fields_item not in excluded_fields_allowed_values: - raise ValueError( - f"Invalid value for `excluded_fields`, must be one of { excluded_fields_allowed_values }" - ) + if 'maintenance_subtype' in kwargs: + maintenance_subtype_allowed_values = ["QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE"] + if kwargs['maintenance_subtype'] not in maintenance_subtype_allowed_values: + raise ValueError( + f"Invalid value for `maintenance_subtype`, must be one of { maintenance_subtype_allowed_values }" + ) 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), - "excludedFields": self.base_client.generate_collection_format_param(kwargs.get("excluded_fields", missing), 'multi') + "availabilityDomain": kwargs.get("availability_domain", missing), + "maintenanceSubtype": kwargs.get("maintenance_subtype", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -28188,7 +32693,7 @@ 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[MaintenanceRunHistorySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28199,26 +32704,34 @@ 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[MaintenanceRunHistorySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kwargs): + def list_maintenance_runs(self, compartment_id, **kwargs): """ - Gets the history of the maintenance update actions performed on the specified Exadata VM cluster on Exascale Infrastructure. + Gets a list of the maintenance runs in the specified compartment. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str compartment_id: (required) + The compartment `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. + :param str target_resource_id: (optional) + The target resource ID. - Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" + :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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" + + :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. @@ -28226,8 +32739,30 @@ def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kw :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 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. + + Allowed values are: "TIME_SCHEDULED", "TIME_ENDED", "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: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED" + + :param str availability_domain: (optional) + A filter to return only resources that match the given availability domain exactly. + + :param str maintenance_subtype: (optional) + The sub-type of the maintenance run. + + Allowed values are: "QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE" :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. @@ -28241,63 +32776,100 @@ def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExadbVmClusterUpdateHistoryEntrySummary` + :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_exadb_vm_cluster_update_history_entries API. + Click `here `__ to see an example of how to use list_maintenance_runs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/updateHistoryEntries" + required_arguments = ['compartmentId'] + resource_path = "/maintenanceRuns" method = "GET" - operation_name = "list_exadb_vm_cluster_update_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdateHistoryEntry/ListExadbVmClusterUpdateHistoryEntries" + operation_name = "list_maintenance_runs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/ListMaintenanceRuns" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "update_type", + "target_resource_id", + "target_resource_type", + "maintenance_type", "limit", "page", - "opc_request_id" + "sort_by", + "sort_order", + "lifecycle_state", + "availability_domain", + "maintenance_subtype" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_exadb_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") + f"list_maintenance_runs got unknown kwargs: {extra_kwargs!r}") - path_params = { - "exadbVmClusterId": exadb_vm_cluster_id - } + 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] + if kwargs['target_resource_type'] not in target_resource_type_allowed_values: + raise ValueError( + f"Invalid value for `target_resource_type`, must be one of { target_resource_type_allowed_values }" + ) - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'maintenance_type' in kwargs: + maintenance_type_allowed_values = ["PLANNED", "UNPLANNED"] + if kwargs['maintenance_type'] not in maintenance_type_allowed_values: + raise ValueError( + f"Invalid value for `maintenance_type`, must be one of { maintenance_type_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(f'Parameter {k} cannot be None, whitespace or empty string') + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_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: + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + if 'maintenance_subtype' in kwargs: + maintenance_subtype_allowed_values = ["QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE"] + if kwargs['maintenance_subtype'] not in maintenance_subtype_allowed_values: raise ValueError( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" + f"Invalid value for `maintenance_subtype`, must be one of { maintenance_subtype_allowed_values }" ) query_params = { - "updateType": kwargs.get("update_type", missing), + "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) + "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), + "maintenanceSubtype": kwargs.get("maintenance_subtype", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -28312,10 +32884,9 @@ def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kw 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[ExadbVmClusterUpdateHistoryEntrySummary]", + response_type="list[MaintenanceRunSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28324,39 +32895,48 @@ def list_exadb_vm_cluster_update_history_entries(self, exadb_vm_cluster_id, **kw 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[ExadbVmClusterUpdateHistoryEntrySummary]", + response_type="list[MaintenanceRunSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_exadb_vm_cluster_updates(self, exadb_vm_cluster_id, **kwargs): + def list_oneoff_patches(self, compartment_id, **kwargs): """ - Lists the maintenance updates that can be applied to the specified Exadata VM cluster on Exascale Infrastructure. + Lists one-off patches in the specified compartment. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str compartment_id: (required) + The compartment `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 str version: (optional) - A filter to return only resources that match the given update version exactly. - :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: "CREATING", "AVAILABLE", "UPDATING", "INACTIVE", "FAILED", "EXPIRED", "DELETING", "DELETED", "TERMINATING", "TERMINATED" + + :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. @@ -28372,56 +32952,65 @@ def list_exadb_vm_cluster_updates(self, exadb_vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExadbVmClusterUpdateSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.OneoffPatchSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_exadb_vm_cluster_updates API. + Click `here `__ to see an example of how to use list_oneoff_patches API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/updates" + required_arguments = ['compartmentId'] + resource_path = "/oneoffPatches" method = "GET" - operation_name = "list_exadb_vm_cluster_updates" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmClusterUpdate/ListExadbVmClusterUpdates" + operation_name = "list_oneoff_patches" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/ListOneoffPatches" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "update_type", - "version", "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( - f"list_exadb_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") - - path_params = { - "exadbVmClusterId": exadb_vm_cluster_id - } + f"list_oneoff_patches got unknown kwargs: {extra_kwargs!r}") - path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_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(f'Parameter {k} cannot be None, whitespace or empty string') + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_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: + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "AVAILABLE", "UPDATING", "INACTIVE", "FAILED", "EXPIRED", "DELETING", "DELETED", "TERMINATING", "TERMINATED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) query_params = { - "updateType": kwargs.get("update_type", missing), - "version": kwargs.get("version", missing), + "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} @@ -28445,10 +33034,9 @@ def list_exadb_vm_cluster_updates(self, exadb_vm_cluster_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[ExadbVmClusterUpdateSummary]", + response_type="list[OneoffPatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28457,24 +33045,23 @@ def list_exadb_vm_cluster_updates(self, exadb_vm_cluster_id, **kwargs): 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[ExadbVmClusterUpdateSummary]", + response_type="list[OneoffPatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_exadb_vm_clusters(self, compartment_id, **kwargs): + def list_params_for_action_type(self, type, **kwargs): """ - Gets a list of the Exadata VM clusters on Exascale Infrastructure in the specified compartment. Applies to Exadata Database Service on Exascale Infrastructure only. + List all the action params and their possible values for a given action type - :param str compartment_id: (required) - The compartment `OCID`__. + :param str type: (required) + The type of the scheduled action - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + Allowed values are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" :param int limit: (optional) The maximum number of items to return per page. @@ -28482,27 +33069,6 @@ def list_exadb_vm_clusters(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. - - 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 Exadata VM clusters on Exascale Infrastructure that match the given lifecycle state exactly. - - Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" - - :param str exascale_db_storage_vault_id: (optional) - A filter to return only Exadata VM clusters on Exascale Infrastructure that match the given Exascale Database Storage Vault ID. - - :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. @@ -28518,18 +33084,18 @@ def list_exadb_vm_clusters(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExadbVmClusterSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ActionParamValuesCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_exadb_vm_clusters API. + Click `here `__ to see an example of how to use list_params_for_action_type API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/exadbVmClusters" + required_arguments = ['type'] + resource_path = "/scheduledActionParams" method = "GET" - operation_name = "list_exadb_vm_clusters" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/ListExadbVmClusters" + operation_name = "list_params_for_action_type" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ActionParamValuesSummary/ListParamsForActionType" # Don't accept unknown kwargs expected_kwargs = [ @@ -28537,48 +33103,23 @@ def list_exadb_vm_clusters(self, compartment_id, **kwargs): "retry_strategy", "limit", "page", - "sort_by", - "sort_order", - "lifecycle_state", - "exascale_db_storage_vault_id", - "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( - f"list_exadb_vm_clusters got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_params_for_action_type got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { 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( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + type_allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if type not in type_allowed_values: + raise ValueError( + f"Invalid value for `type`, must be one of { type_allowed_values }" + ) query_params = { - "compartmentId": compartment_id, + "type": type, "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), - "exascaleDbStorageVaultId": kwargs.get("exascale_db_storage_vault_id", 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} @@ -28604,7 +33145,7 @@ def list_exadb_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExadbVmClusterSummary]", + response_type="ActionParamValuesCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28615,49 +33156,51 @@ def list_exadb_vm_clusters(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExadbVmClusterSummary]", + response_type="ActionParamValuesCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_exascale_db_storage_vaults(self, compartment_id, **kwargs): + def list_pdb_conversion_history_entries(self, database_id, **kwargs): """ - Gets a list of the Exadata Database Storage Vaults in the specified compartment. + Gets the pluggable database conversion history for a specified database in a bare metal or virtual machine DB system. - :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 pdb_conversion_action: (optional) + A filter to return only the pluggable database conversion history entries that match the specified conversion action. For example, you can use this filter to return only entries for the precheck operation. - :param str page: (optional) - The pagination token to continue listing from. + Allowed values are: "PRECHECK", "CONVERT", "SYNC", "SYNC_ROLLBACK" + + :param str lifecycle_state: (optional) + A filter to return only the pluggable database conversion history entries that match the specified lifecycle state. For example, you can use this filter to return only entries in the \"failed\" lifecycle state. + + 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 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`). The default order for `TIMECREATED` is ascending. - Allowed values are: "TIMECREATED", "DISPLAYNAME" + 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 lifecycle_state: (optional) - A filter to return only Exadata Database Storage Vaults that match the given lifecycle state exactly. - - 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 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. @@ -28670,38 +33213,62 @@ def list_exascale_db_storage_vaults(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExascaleDbStorageVaultSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PdbConversionHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_exascale_db_storage_vaults API. + Click `here `__ to see an example of how to use list_pdb_conversion_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/exascaleDbStorageVaults" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/pdbConversionHistoryEntries" method = "GET" - operation_name = "list_exascale_db_storage_vaults" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/ListExascaleDbStorageVaults" + operation_name = "list_pdb_conversion_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListPdbConversionHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", + "pdb_conversion_action", + "lifecycle_state", "sort_by", "sort_order", - "lifecycle_state", - "display_name", - "opc_request_id" + "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( - f"list_exascale_db_storage_vaults got unknown kwargs: {extra_kwargs!r}") + f"list_pdb_conversion_history_entries got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'pdb_conversion_action' in kwargs: + pdb_conversion_action_allowed_values = ["PRECHECK", "CONVERT", "SYNC", "SYNC_ROLLBACK"] + if kwargs['pdb_conversion_action'] not in pdb_conversion_action_allowed_values: + raise ValueError( + f"Invalid value for `pdb_conversion_action`, must be one of { pdb_conversion_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( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + sort_by_allowed_values = ["TIMESTARTED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -28714,21 +33281,13 @@ def list_exascale_db_storage_vaults(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) - query_params = { - "compartmentId": compartment_id, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), + "pdbConversionAction": kwargs.get("pdb_conversion_action", missing), + "lifecycleState": kwargs.get("lifecycle_state", 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) + "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} @@ -28752,9 +33311,10 @@ def list_exascale_db_storage_vaults(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[ExascaleDbStorageVaultSummary]", + response_type="list[PdbConversionHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28763,26 +33323,29 @@ def list_exascale_db_storage_vaults(self, compartment_id, **kwargs): 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[ExascaleDbStorageVaultSummary]", + response_type="list[PdbConversionHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_external_container_databases(self, compartment_id, **kwargs): + def list_pluggable_databases(self, **kwargs): """ - Gets a list of the external container databases in the specified compartment. + Gets a list of the pluggable databases in a database or compartment. You must provide either a `databaseId` or `compartmentId` value. - :param str compartment_id: (required) + :param str compartment_id: (optional) 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 database_id: (optional) + The `OCID`__ of the database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param int limit: (optional) The maximum number of items to return per page. @@ -28791,12 +33354,9 @@ def list_external_container_databases(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 PDBNAME is ascending. The PDBNAME sort order is case sensitive. - Allowed values are: "DISPLAYNAME", "TIMECREATED" + Allowed values are: "PDBNAME", "TIMECREATED" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -28804,12 +33364,12 @@ def list_external_container_databases(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. + A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING", "FAILED", "RELOCATING", "RELOCATED", "REFRESHING", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "DISABLED" - :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 pdb_name: (optional) + A filter to return only pluggable databases that match the entire 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. @@ -28823,38 +33383,39 @@ def list_external_container_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalContainerDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PluggableDatabaseSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_external_container_databases API. + Click `here `__ to see an example of how to use list_pluggable_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/externalcontainerdatabases" + required_arguments = [] + resource_path = "/pluggableDatabases" method = "GET" - operation_name = "list_external_container_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ListExternalContainerDatabases" + operation_name = "list_pluggable_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ListPluggableDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", + "compartment_id", + "database_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "display_name" + "pdb_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_external_container_databases got unknown kwargs: {extra_kwargs!r}") + f"list_pluggable_databases got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + sort_by_allowed_values = ["PDBNAME", "TIMECREATED"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -28868,29 +33429,28 @@ def list_external_container_databases(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING", "FAILED", "RELOCATING", "RELOCATED", "REFRESHING", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "DISABLED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) query_params = { - "compartmentId": compartment_id, + "compartmentId": kwargs.get("compartment_id", missing), + "databaseId": kwargs.get("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), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) + "pdbName": kwargs.get("pdb_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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -28907,7 +33467,7 @@ def list_external_container_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalContainerDatabaseSummary]", + response_type="list[PluggableDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -28918,29 +33478,31 @@ def list_external_container_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalContainerDatabaseSummary]", + response_type="list[PluggableDatabaseSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_external_database_connectors(self, compartment_id, external_database_id, **kwargs): + def list_recommended_scheduled_actions(self, scheduling_policy_id, scheduling_policy_target_resource_id, plan_intent, **kwargs): """ - Gets a list of the external database connectors in the specified compartment. + Returns a recommended Scheduled Actions configuration for a given resource, plan intent and scheduling policy. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str external_database_id: (required) - The `OCID`__ of the external database whose connectors will be listed. + :param str scheduling_policy_target_resource_id: (required) + The target resource `OCID`__ the scheduled actions will be for. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str opc_request_id: (optional) - Unique identifier for the request. + :param str plan_intent: (required) + The scheduling plan intent the scheduled actions will be for. + + Allowed values are: "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE" :param int limit: (optional) The maximum number of items to return per page. @@ -28948,26 +33510,8 @@ def list_external_database_connectors(self, compartment_id, external_database_id :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", "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. @@ -28981,66 +33525,53 @@ def list_external_database_connectors(self, compartment_id, external_database_id allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalDatabaseConnectorSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.RecommendedScheduledActionsCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_external_database_connectors API. + Click `here `__ to see an example of how to use list_recommended_scheduled_actions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'externalDatabaseId'] - resource_path = "/externaldatabaseconnectors" + required_arguments = ['schedulingPolicyId', 'schedulingPolicyTargetResourceId', 'planIntent'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/recommendedScheduledActions" method = "GET" - operation_name = "list_external_database_connectors" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/ListExternalDatabaseConnectors" + operation_name = "list_recommended_scheduled_actions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/RecommendedScheduledActionSummary/ListRecommendedScheduledActions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_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( - f"list_external_database_connectors got unknown kwargs: {extra_kwargs!r}") + f"list_recommended_scheduled_actions got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + path_params = { + "schedulingPolicyId": scheduling_policy_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { 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"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') + + plan_intent_allowed_values = ["EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE"] + if plan_intent not in plan_intent_allowed_values: + raise ValueError( + f"Invalid value for `plan_intent`, must be one of { plan_intent_allowed_values }" + ) query_params = { - "compartmentId": compartment_id, - "externalDatabaseId": external_database_id, + "schedulingPolicyTargetResourceId": scheduling_policy_target_resource_id, + "planIntent": plan_intent, "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} @@ -29064,9 +33595,10 @@ def list_external_database_connectors(self, compartment_id, external_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[ExternalDatabaseConnectorSummary]", + response_type="RecommendedScheduledActionsCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29075,17 +33607,18 @@ def list_external_database_connectors(self, compartment_id, external_database_id 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[ExternalDatabaseConnectorSummary]", + response_type="RecommendedScheduledActionsCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_external_non_container_databases(self, compartment_id, **kwargs): + def list_scheduled_actions(self, compartment_id, **kwargs): """ - Gets a list of the ExternalNonContainerDatabases in the specified compartment. + Lists the Scheduled Action resources in the specified compartment. :param str compartment_id: (required) @@ -29093,36 +33626,42 @@ def list_external_non_container_databases(self, compartment_id, **kwargs): __ 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 opc_request_id: (optional) + Unique identifier for the request. :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. + :param str service_type: (optional) + A filter to return only resources that match the given service type exactly. - Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + :param str scheduling_plan_id: (optional) + A filter to return only resources that match the given scheduling policy id 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 sort_by: (optional) + The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. + + Allowed values are: "TIMECREATED", "DISPLAYNAME" + + :param str id: (optional) + A filter to return only resources that match the given Scheduled Action id exactly. + + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. + + Allowed values are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED" + :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. @@ -29135,42 +33674,38 @@ def list_external_non_container_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalNonContainerDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ScheduledActionCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_external_non_container_databases API. + Click `here `__ to see an example of how to use list_scheduled_actions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/externalnoncontainerdatabases" + resource_path = "/scheduledActions" method = "GET" - operation_name = "list_external_non_container_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/ListExternalNonContainerDatabases" + operation_name = "list_scheduled_actions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ScheduledAction/ListScheduledActions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", "limit", "page", - "sort_by", + "opc_request_id", "sort_order", - "lifecycle_state", - "display_name" + "service_type", + "scheduling_plan_id", + "display_name", + "sort_by", + "id", + "lifecycle_state" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_external_non_container_databases got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_scheduled_actions got unknown kwargs: {extra_kwargs!r}") if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -29179,21 +33714,31 @@ def list_external_non_container_databases(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + lifecycle_state_allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) query_params = { - "compartmentId": compartment_id, "limit": kwargs.get("limit", missing), + "compartmentId": compartment_id, "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) + "serviceType": kwargs.get("service_type", missing), + "schedulingPlanId": kwargs.get("scheduling_plan_id", missing), + "displayName": kwargs.get("display_name", missing), + "sortBy": kwargs.get("sort_by", missing), + "id": kwargs.get("id", 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} @@ -29219,7 +33764,7 @@ def list_external_non_container_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalNonContainerDatabaseSummary]", + response_type="ScheduledActionCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29230,16 +33775,15 @@ def list_external_non_container_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalNonContainerDatabaseSummary]", + response_type="ScheduledActionCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_external_pluggable_databases(self, compartment_id, **kwargs): + def list_scheduling_plans(self, compartment_id, **kwargs): """ - Gets a list of the :func:`create_external_pluggable_database_details` - resources in the specified compartment. + Lists the Scheduling Plan resources in the specified compartment. :param str compartment_id: (required) @@ -29247,27 +33791,19 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): __ 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 - :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. - Allowed values are: "DISPLAYNAME", "TIMECREATED" + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -29275,13 +33811,22 @@ def list_external_pluggable_databases(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. + A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED" + Allowed values are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED" + + :param str scheduling_policy_id: (optional) + A filter to return only resources that match the given scheduling policy id 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 resource_id: (optional) + A filter to return only resources that match the given resource id exactly. + + :param str id: (optional) + A filter to return only resources that match the given Schedule Plan id 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. @@ -29294,39 +33839,41 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.ExternalPluggableDatabaseSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingPlanCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_external_pluggable_databases API. + Click `here `__ to see an example of how to use list_scheduling_plans API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/externalpluggabledatabases" + resource_path = "/schedulingPlans" method = "GET" - operation_name = "list_external_pluggable_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/ListExternalPluggableDatabases" + operation_name = "list_scheduling_plans" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/ListSchedulingPlans" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "external_container_database_id", "limit", "page", + "opc_request_id", "sort_by", "sort_order", "lifecycle_state", - "display_name" + "scheduling_policy_id", + "display_name", + "resource_id", + "id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_external_pluggable_databases got unknown kwargs: {extra_kwargs!r}") + f"list_scheduling_plans got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["DISPLAYNAME", "TIMECREATED"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -29340,7 +33887,7 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "NOT_CONNECTED", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED"] + lifecycle_state_allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -29348,13 +33895,15 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, - "externalContainerDatabaseId": kwargs.get("external_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), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", missing) + "schedulingPolicyId": kwargs.get("scheduling_policy_id", missing), + "displayName": kwargs.get("display_name", missing), + "resourceId": kwargs.get("resource_id", missing), + "id": kwargs.get("id", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} @@ -29380,7 +33929,7 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalPluggableDatabaseSummary]", + response_type="SchedulingPlanCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29391,15 +33940,15 @@ def list_external_pluggable_databases(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[ExternalPluggableDatabaseSummary]", + response_type="SchedulingPlanCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_flex_components(self, compartment_id, **kwargs): + def list_scheduling_policies(self, 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. + Lists the Scheduling Policy resources in the specified compartment. :param str compartment_id: (required) @@ -29407,24 +33956,32 @@ def list_flex_components(self, compartment_id, **kwargs): __ 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 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 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 str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. - :param int limit: (optional) - The maximum number of items to return per page. + Allowed values are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED" - :param str page: (optional) - The pagination token to continue listing from. + :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. @@ -29438,33 +33995,42 @@ def list_flex_components(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SchedulingPolicySummary` :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_scheduling_policies API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['compartmentId'] - resource_path = "/dbSystemShapes/flexComponents" + resource_path = "/schedulingPolicies" method = "GET" - operation_name = "list_flex_components" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/FlexComponentCollection/ListFlexComponents" + operation_name = "list_scheduling_policies" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/ListSchedulingPolicies" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "name", - "sort_order", - "sort_by", "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( - f"list_flex_components got unknown kwargs: {extra_kwargs!r}") + f"list_scheduling_policies got unknown kwargs: {extra_kwargs!r}") + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -29473,27 +34039,30 @@ def list_flex_components(self, compartment_id, **kwargs): f"Invalid value for `sort_order`, must be one of { 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", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + f"Invalid value for `lifecycle_state`, must be one of { 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -29510,7 +34079,7 @@ def list_flex_components(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="FlexComponentCollection", + response_type="list[SchedulingPolicySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29521,57 +34090,53 @@ def list_flex_components(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="FlexComponentCollection", + response_type="list[SchedulingPolicySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_gi_version_minor_versions(self, version, **kwargs): + def list_scheduling_windows(self, scheduling_policy_id, **kwargs): """ - Gets a list of supported Oracle Grid Infrastructure minor versions for the given major version and shape family. + Lists the Scheduling Window resources in the specified compartment. - :param str version: (required) - The Oracle Grid Infrastructure major version. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. - :param str availability_domain: (optional) - The target availability domain. Only passed if the limit is AD-specific. + __ 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 str opc_request_id: (optional) - Unique identifier for the request. - - :param str shape_family: (optional) - If provided, filters the results to the set of database versions which are supported for the given shape family. - - Allowed values are: "SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS" + :param int limit: (optional) + The maximum number of items to return per page. - :param bool is_gi_version_for_provisioning: (optional) - If true, returns the Grid Infrastructure versions that can be used for provisioning a cluster + :param str page: (optional) + The pagination token to continue listing from. - :param str shape: (optional) - If provided, filters the results for the given shape. + :param str opc_request_id: (optional) + Unique identifier for the request. :param str sort_by: (optional) - Sort by VERSION. Default order for VERSION 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: "VERSION" + 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 int limit: (optional) - The maximum number of items to return per page. + :param str lifecycle_state: (optional) + A filter to return only resources that match the given lifecycle state exactly. - :param str page: (optional) - The pagination token to continue listing from. + Allowed values are: "CREATING", "AVAILABLE", "UPDATING", "FAILED", "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 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. @@ -29585,41 +34150,39 @@ def list_gi_version_minor_versions(self, version, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.GiMinorVersionSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.SchedulingWindowSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_gi_version_minor_versions API. + Click `here `__ to see an example of how to use list_scheduling_windows API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['version'] - resource_path = "/giVersions/{version}/minorVersions" + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/schedulingWindows" method = "GET" - operation_name = "list_gi_version_minor_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/GiMinorVersionSummary/ListGiVersionMinorVersions" + operation_name = "list_scheduling_windows" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingWindow/ListSchedulingWindows" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "availability_domain", "compartment_id", + "limit", + "page", "opc_request_id", - "shape_family", - "is_gi_version_for_provisioning", - "shape", "sort_by", "sort_order", - "limit", - "page" + "lifecycle_state", + "display_name" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_gi_version_minor_versions got unknown kwargs: {extra_kwargs!r}") + f"list_scheduling_windows got unknown kwargs: {extra_kwargs!r}") path_params = { - "version": version + "schedulingPolicyId": scheduling_policy_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -29628,15 +34191,8 @@ def list_gi_version_minor_versions(self, version, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'shape_family' in kwargs: - shape_family_allowed_values = ["SINGLENODE", "YODA", "VIRTUALMACHINE", "EXADATA", "EXACC", "EXADB_XS"] - if kwargs['shape_family'] not in shape_family_allowed_values: - raise ValueError( - f"Invalid value for `shape_family`, must be one of { shape_family_allowed_values }" - ) - if 'sort_by' in kwargs: - sort_by_allowed_values = ["VERSION"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -29649,16 +34205,21 @@ def list_gi_version_minor_versions(self, version, **kwargs): f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" ) + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + query_params = { - "availabilityDomain": kwargs.get("availability_domain", missing), "compartmentId": kwargs.get("compartment_id", missing), - "shapeFamily": kwargs.get("shape_family", missing), - "isGiVersionForProvisioning": kwargs.get("is_gi_version_for_provisioning", missing), - "shape": kwargs.get("shape", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), "sortBy": kwargs.get("sort_by", missing), "sortOrder": kwargs.get("sort_order", missing), - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", 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} @@ -29685,7 +34246,7 @@ def list_gi_version_minor_versions(self, version, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[GiMinorVersionSummary]", + response_type="list[SchedulingWindowSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29697,15 +34258,15 @@ def list_gi_version_minor_versions(self, version, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[GiMinorVersionSummary]", + response_type="list[SchedulingWindowSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_gi_versions(self, compartment_id, **kwargs): + def list_system_versions(self, compartment_id, shape, gi_version, **kwargs): """ - Gets a list of supported GI versions. + Gets a list of supported Exadata system versions for a given shape and GI version. :param str compartment_id: (required) @@ -29713,6 +34274,12 @@ def list_gi_versions(self, compartment_id, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str shape: (required) + Specifies shape query parameter. + + :param str gi_version: (required) + Specifies gi version query parameter. + :param int limit: (optional) The maximum number of items to return per page. @@ -29724,11 +34291,8 @@ def list_gi_versions(self, compartment_id, **kwargs): Allowed values are: "ASC", "DESC" - :param str shape: (optional) - If provided, filters the results for the given shape. - - :param str availability_domain: (optional) - The target availability domain. Only passed if the limit is AD-specific. + :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. @@ -29742,18 +34306,18 @@ def list_gi_versions(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.SystemVersionCollection` :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_system_versions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/giVersions" + required_arguments = ['compartmentId', 'shape', 'giVersion'] + resource_path = "/systemVersions" method = "GET" - operation_name = "list_gi_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/GiVersionSummary/ListGiVersions" + operation_name = "list_system_versions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SystemVersionCollection/ListSystemVersions" # Don't accept unknown kwargs expected_kwargs = [ @@ -29762,13 +34326,12 @@ def list_gi_versions(self, compartment_id, **kwargs): "limit", "page", "sort_order", - "shape", - "availability_domain" + "opc_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_gi_versions got unknown kwargs: {extra_kwargs!r}") + f"list_system_versions got unknown kwargs: {extra_kwargs!r}") if 'sort_order' in kwargs: sort_order_allowed_values = ["ASC", "DESC"] @@ -29782,15 +34345,17 @@ def list_gi_versions(self, compartment_id, **kwargs): "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "sortOrder": kwargs.get("sort_order", missing), - "shape": kwargs.get("shape", missing), - "availabilityDomain": kwargs.get("availability_domain", missing) + "shape": shape, + "giVersion": gi_version } 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -29807,7 +34372,7 @@ def list_gi_versions(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[GiVersionSummary]", + response_type="SystemVersionCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29818,16 +34383,21 @@ def list_gi_versions(self, compartment_id, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[GiVersionSummary]", + response_type="SystemVersionCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_key_stores(self, compartment_id, **kwargs): + def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, **kwargs): """ - Gets a list of key stores in the specified compartment. + 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`__. @@ -29840,6 +34410,24 @@ def list_key_stores(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. + + 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_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED", "NEEDS_ATTENTION" + + :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. @@ -29855,18 +34443,18 @@ def list_key_stores(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.VmClusterNetworkSummary` :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_networks API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/keyStores" + required_arguments = ['exadataInfrastructureId', 'compartmentId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" method = "GET" - operation_name = "list_key_stores" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStoreSummary/ListKeyStores" + operation_name = "list_vm_cluster_networks" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/ListVmClusterNetworks" # Don't accept unknown kwargs expected_kwargs = [ @@ -29874,17 +34462,56 @@ def list_key_stores(self, compartment_id, **kwargs): "retry_strategy", "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( - f"list_key_stores got unknown kwargs: {extra_kwargs!r}") + f"list_vm_cluster_networks got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { 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", "NEEDS_ATTENTION"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { 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} @@ -29908,9 +34535,10 @@ 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[VmClusterNetworkSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -29919,67 +34547,30 @@ def list_key_stores(self, compartment_id, **kwargs): 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[VmClusterNetworkSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_maintenance_run_history(self, compartment_id, **kwargs): + def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): """ - Gets a list of the maintenance run histories in the specified compartment. - - - :param str compartment_id: (required) - The compartment `OCID`__. - - __ 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" - - :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 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. - - Allowed values are: "TIME_SCHEDULED", "TIME_ENDED", "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) - The state of the maintenance run history. + Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system. - Allowed values are: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED" - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. - :param str maintenance_subtype: (optional) - The sub-type of the maintenance run. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - Allowed values are: "QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE" + :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. @@ -29993,93 +34584,44 @@ def list_maintenance_run_history(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.MaintenanceRunHistorySummary` + :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_maintenance_run_history API. + Click `here `__ to see an example of how to use list_vm_cluster_patch_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/maintenanceRunHistory" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries" method = "GET" - operation_name = "list_maintenance_run_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRunHistory/ListMaintenanceRunHistory" + operation_name = "list_vm_cluster_patch_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListVmClusterPatchHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "target_resource_id", - "target_resource_type", - "maintenance_type", "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "availability_domain", - "maintenance_subtype" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_maintenance_run_history got unknown kwargs: {extra_kwargs!r}") - - 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] - if kwargs['target_resource_type'] not in target_resource_type_allowed_values: - raise ValueError( - f"Invalid value for `target_resource_type`, must be one of { 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( - f"Invalid value for `maintenance_type`, must be one of { maintenance_type_allowed_values }" - ) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_vm_cluster_patch_history_entries got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + path_params = { + "vmClusterId": vm_cluster_id + } - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - if 'maintenance_subtype' in kwargs: - maintenance_subtype_allowed_values = ["QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE"] - if kwargs['maintenance_subtype'] not in maintenance_subtype_allowed_values: - raise ValueError( - f"Invalid value for `maintenance_subtype`, must be one of { maintenance_subtype_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(f'Parameter {k} cannot be None, whitespace or empty string') 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), - "availabilityDomain": kwargs.get("availability_domain", missing), - "maintenanceSubtype": kwargs.get("maintenance_subtype", 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} @@ -30101,9 +34643,10 @@ def list_maintenance_run_history(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[MaintenanceRunHistorySummary]", + response_type="list[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30112,68 +34655,31 @@ def list_maintenance_run_history(self, compartment_id, **kwargs): 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[MaintenanceRunHistorySummary]", + response_type="list[PatchHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_maintenance_runs(self, compartment_id, **kwargs): + def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): """ - Gets a list of the maintenance runs 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 - :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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER" - - :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 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. - - Allowed values are: "TIME_SCHEDULED", "TIME_ENDED", "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: "SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED" - - :param str availability_domain: (optional) - A filter to return only resources that match the given availability domain exactly. - - :param str maintenance_subtype: (optional) - The sub-type of the maintenance run. - - Allowed values are: "QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE" - :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. @@ -30186,93 +34692,44 @@ def list_maintenance_runs(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PatchSummary` :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_cluster_patches API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/maintenanceRuns" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/patches" method = "GET" - operation_name = "list_maintenance_runs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/ListMaintenanceRuns" + operation_name = "list_vm_cluster_patches" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListVmClusterPatches" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "target_resource_id", - "target_resource_type", - "maintenance_type", "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "availability_domain", - "maintenance_subtype" + "page" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"list_maintenance_runs got unknown kwargs: {extra_kwargs!r}") - - 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", "AUTONOMOUS_VM_CLUSTER", "AUTONOMOUS_DATABASE", "CLOUD_AUTONOMOUS_VM_CLUSTER"] - if kwargs['target_resource_type'] not in target_resource_type_allowed_values: - raise ValueError( - f"Invalid value for `target_resource_type`, must be one of { 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( - f"Invalid value for `maintenance_type`, must be one of { maintenance_type_allowed_values }" - ) - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIME_SCHEDULED", "TIME_ENDED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"list_vm_cluster_patches got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + path_params = { + "vmClusterId": vm_cluster_id + } - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["SCHEDULED", "IN_PROGRESS", "SUCCEEDED", "SKIPPED", "FAILED", "UPDATING", "DELETING", "DELETED", "CANCELED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) + path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} - if 'maintenance_subtype' in kwargs: - maintenance_subtype_allowed_values = ["QUARTERLY", "HARDWARE", "CRITICAL", "INFRASTRUCTURE", "DATABASE", "ONEOFF", "SECURITY_MONTHLY", "TIMEZONE", "CUSTOM_DATABASE_SOFTWARE_IMAGE"] - if kwargs['maintenance_subtype'] not in maintenance_subtype_allowed_values: - raise ValueError( - f"Invalid value for `maintenance_subtype`, must be one of { maintenance_subtype_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(f'Parameter {k} cannot be None, whitespace or empty string') 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), - "availabilityDomain": kwargs.get("availability_domain", missing), - "maintenanceSubtype": kwargs.get("maintenance_subtype", 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} @@ -30294,9 +34751,10 @@ def list_maintenance_runs(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[MaintenanceRunSummary]", + response_type="list[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30305,47 +34763,40 @@ def list_maintenance_runs(self, compartment_id, **kwargs): 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[MaintenanceRunSummary]", + response_type="list[PatchSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_oneoff_patches(self, compartment_id, **kwargs): + def list_vm_cluster_update_history_entries(self, vm_cluster_id, **kwargs): """ - Lists one-off patches in the specified compartment. + Gets the history of the maintenance update actions performed on the specified VM cluster. Applies to Exadata Cloud@Customer instances only. - :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 - :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`). + :param str update_type: (optional) + A filter to return only resources that match the given update type exactly. - Allowed values are: "ASC", "DESC" + Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" :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 given lifecycle state exactly. - Allowed values are: "CREATING", "AVAILABLE", "UPDATING", "INACTIVE", "FAILED", "EXPIRED", "DELETING", "DELETED", "TERMINATING", "TERMINATED" + Allowed values are: "IN_PROGRESS", "SUCCEEDED", "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 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. @@ -30362,65 +34813,63 @@ def list_oneoff_patches(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.OneoffPatchSummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterUpdateHistoryEntrySummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_oneoff_patches API. + Click `here `__ to see an example of how to use list_vm_cluster_update_history_entries API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/oneoffPatches" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/updateHistoryEntries" method = "GET" - operation_name = "list_oneoff_patches" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/ListOneoffPatches" + operation_name = "list_vm_cluster_update_history_entries" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdateHistoryEntry/ListVmClusterUpdateHistoryEntries" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "update_type", + "lifecycle_state", "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( - f"list_oneoff_patches got unknown kwargs: {extra_kwargs!r}") + f"list_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + path_params = { + "vmClusterId": vm_cluster_id + } - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["CREATING", "AVAILABLE", "UPDATING", "INACTIVE", "FAILED", "EXPIRED", "DELETING", "DELETED", "TERMINATING", "TERMINATED"] + lifecycle_state_allowed_values = ["IN_PROGRESS", "SUCCEEDED", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { 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), + "updateType": kwargs.get("update_type", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), - "displayName": kwargs.get("display_name", 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} @@ -30444,9 +34893,10 @@ def list_oneoff_patches(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[OneoffPatchSummary]", + response_type="list[VmClusterUpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30455,46 +34905,34 @@ def list_oneoff_patches(self, compartment_id, **kwargs): 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[OneoffPatchSummary]", + response_type="list[VmClusterUpdateHistoryEntrySummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_pdb_conversion_history_entries(self, database_id, **kwargs): + def list_vm_cluster_updates(self, vm_cluster_id, **kwargs): """ - Gets the pluggable database conversion history for a specified database in a bare metal or virtual machine DB system. + Lists the maintenance updates that can be applied to the specified VM cluster. Applies to Exadata Cloud@Customer instances only. - :param str database_id: (required) - The database `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str pdb_conversion_action: (optional) - A filter to return only the pluggable database conversion history entries that match the specified conversion action. For example, you can use this filter to return only entries for the precheck operation. + :param str update_type: (optional) + A filter to return only resources that match the given update type exactly. - Allowed values are: "PRECHECK", "CONVERT", "SYNC", "SYNC_ROLLBACK" + Allowed values are: "GI_UPGRADE", "GI_PATCH", "OS_UPDATE" :param str lifecycle_state: (optional) - A filter to return only the pluggable database conversion history entries that match the specified lifecycle state. For example, you can use this filter to return only entries in the \"failed\" lifecycle state. - - Allowed values are: "SUCCEEDED", "FAILED", "IN_PROGRESS" - - :param str sort_by: (optional) - The field to sort by. You can provide one sort order (`sortOrder`). The 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" + A filter to return only resources that match the given lifecycle state exactly. - :param str opc_request_id: (optional) - Unique identifier for the request. + Allowed values are: "AVAILABLE", "SUCCESS", "IN_PROGRESS", "FAILED" :param int limit: (optional) The maximum number of items to return per page. @@ -30502,6 +34940,9 @@ def list_pdb_conversion_history_entries(self, database_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. @@ -30514,38 +34955,36 @@ def list_pdb_conversion_history_entries(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PdbConversionHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterUpdateSummary` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_pdb_conversion_history_entries API. + Click `here `__ to see an example of how to use list_vm_cluster_updates API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/pdbConversionHistoryEntries" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/updates" method = "GET" - operation_name = "list_pdb_conversion_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ListPdbConversionHistoryEntries" + operation_name = "list_vm_cluster_updates" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdate/ListVmClusterUpdates" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "pdb_conversion_action", + "update_type", "lifecycle_state", - "sort_by", - "sort_order", - "opc_request_id", "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( - f"list_pdb_conversion_history_entries got unknown kwargs: {extra_kwargs!r}") + f"list_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "vmClusterId": vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -30554,39 +34993,23 @@ def list_pdb_conversion_history_entries(self, database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - if 'pdb_conversion_action' in kwargs: - pdb_conversion_action_allowed_values = ["PRECHECK", "CONVERT", "SYNC", "SYNC_ROLLBACK"] - if kwargs['pdb_conversion_action'] not in pdb_conversion_action_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( - f"Invalid value for `pdb_conversion_action`, must be one of { pdb_conversion_action_allowed_values }" + f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["SUCCEEDED", "FAILED", "IN_PROGRESS"] + lifecycle_state_allowed_values = ["AVAILABLE", "SUCCESS", "IN_PROGRESS", "FAILED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { 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( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) - query_params = { - "pdbConversionAction": kwargs.get("pdb_conversion_action", missing), + "updateType": kwargs.get("update_type", 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) } @@ -30615,7 +35038,7 @@ def list_pdb_conversion_history_entries(self, database_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PdbConversionHistoryEntrySummary]", + response_type="list[VmClusterUpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30627,26 +35050,25 @@ def list_pdb_conversion_history_entries(self, database_id, **kwargs): path_params=path_params, query_params=query_params, header_params=header_params, - response_type="list[PdbConversionHistoryEntrySummary]", + response_type="list[VmClusterUpdateSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_pluggable_databases(self, **kwargs): + def list_vm_clusters(self, compartment_id, **kwargs): """ - Gets a list of the pluggable databases in a database or compartment. You must provide either a `databaseId` or `compartmentId` value. + 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: (optional) + :param str compartment_id: (required) The compartment `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str database_id: (optional) - The `OCID`__ of the database. - - __ 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. @@ -30655,9 +35077,9 @@ def list_pluggable_databases(self, **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 PDBNAME is ascending. The PDBNAME 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: "PDBNAME", "TIMECREATED" + Allowed values are: "TIMECREATED", "DISPLAYNAME" :param str sort_order: (optional) The sort order to use, either ascending (`ASC`) or descending (`DESC`). @@ -30667,10 +35089,13 @@ def list_pluggable_databases(self, **kwargs): :param str lifecycle_state: (optional) A filter to return only resources that match the given lifecycle state exactly. - Allowed values are: "PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING", "FAILED", "RELOCATING", "RELOCATED", "REFRESHING", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "DISABLED" + Allowed values are: "PROVISIONING", "AVAILABLE", "UPDATING", "TERMINATING", "TERMINATED", "FAILED", "MAINTENANCE_IN_PROGRESS" - :param str pdb_name: (optional) - A filter to return only pluggable databases that match the entire name given. The match is not case sensitive. + :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. @@ -30684,39 +35109,39 @@ def list_pluggable_databases(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.PluggableDatabaseSummary` + :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_pluggable_databases API. + Click `here `__ to see an example of how to use list_vm_clusters API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/pluggableDatabases" + required_arguments = ['compartmentId'] + resource_path = "/vmClusters" method = "GET" - operation_name = "list_pluggable_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ListPluggableDatabases" + operation_name = "list_vm_clusters" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/ListVmClusters" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "compartment_id", - "database_id", + "exadata_infrastructure_id", "limit", "page", "sort_by", "sort_order", "lifecycle_state", - "pdb_name" + "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( - f"list_pluggable_databases got unknown kwargs: {extra_kwargs!r}") + f"list_vm_clusters got unknown kwargs: {extra_kwargs!r}") if 'sort_by' in kwargs: - sort_by_allowed_values = ["PDBNAME", "TIMECREATED"] + sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] if kwargs['sort_by'] not in sort_by_allowed_values: raise ValueError( f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" @@ -30730,28 +35155,30 @@ def list_pluggable_databases(self, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["PROVISIONING", "AVAILABLE", "TERMINATING", "TERMINATED", "UPDATING", "FAILED", "RELOCATING", "RELOCATED", "REFRESHING", "RESTORE_IN_PROGRESS", "RESTORE_FAILED", "BACKUP_IN_PROGRESS", "DISABLED"] + 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( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" ) query_params = { - "compartmentId": kwargs.get("compartment_id", missing), - "databaseId": kwargs.get("database_id", missing), + "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), - "pdbName": kwargs.get("pdb_name", 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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -30768,7 +35195,7 @@ def list_pluggable_databases(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[PluggableDatabaseSummary]", + response_type="list[VmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30779,42 +35206,41 @@ def list_pluggable_databases(self, **kwargs): method=method, query_params=query_params, header_params=header_params, - response_type="list[PluggableDatabaseSummary]", + response_type="list[VmClusterSummary]", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_system_versions(self, compartment_id, shape, gi_version, **kwargs): + def local_clone_pluggable_database(self, local_clone_pluggable_database_details, pluggable_database_id, **kwargs): """ - Gets a list of supported Exadata system versions for a given shape and GI version. - - - :param str compartment_id: (required) - The compartment `OCID`__. - - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - - :param str shape: (required) - Specifies shape query parameter. + **Deprecated.** Use :func:`create_pluggable_database` for Pluggable Database LocalClone Operation. + Clones and starts a pluggable database (PDB) in the same database (CDB) as the source PDB. The source PDB must be in the `READ_WRITE` openMode to perform the clone operation. - :param str gi_version: (required) - Specifies gi version query parameter. - :param int limit: (optional) - The maximum number of items to return per page. + :param oci.database.models.LocalClonePluggableDatabaseDetails local_clone_pluggable_database_details: (required) + Request to clone a pluggable database locally. - :param str page: (optional) - The pagination token to continue listing from. + :param str pluggable_database_id: (required) + The database `OCID`__. - :param str sort_order: (optional) - The sort order to use, either ascending (`ASC`) or descending (`DESC`). + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - Allowed values are: "ASC", "DESC" + :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. @@ -30827,54 +35253,48 @@ def list_system_versions(self, compartment_id, shape, gi_version, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SystemVersionCollection` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_system_versions API. + Click `here `__ to see an example of how to use local_clone_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId', 'shape', 'giVersion'] - resource_path = "/systemVersions" - method = "GET" - operation_name = "list_system_versions" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SystemVersionCollection/ListSystemVersions" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/localClone" + method = "POST" + operation_name = "local_clone_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/LocalClonePluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "sort_order", - "opc_request_id" + "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( - f"list_system_versions got unknown kwargs: {extra_kwargs!r}") - - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + f"local_clone_pluggable_database got unknown kwargs: {extra_kwargs!r}") - query_params = { - "compartmentId": compartment_id, - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing), - "sortOrder": kwargs.get("sort_order", missing), - "shape": shape, - "giVersion": gi_version + path_params = { + "pluggableDatabaseId": pluggable_database_id } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -30885,15 +35305,17 @@ def list_system_versions(self, compartment_id, shape, gi_version, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( 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="SystemVersionCollection", + body=local_clone_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -30902,56 +35324,43 @@ def list_system_versions(self, compartment_id, shape, gi_version, **kwargs): 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="SystemVersionCollection", + body=local_clone_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, **kwargs): + def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): """ - Gets a list of the VM cluster networks in the specified compartment. Applies to Exadata Cloud@Customer instances only. - + Migrates the Exadata DB system to the new `Exadata resource model`__. + All related resources will be migrated. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str compartment_id: (required) - The compartment `OCID`__. + :param str db_system_id: (required) + The DB system `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: "CREATING", "REQUIRES_VALIDATION", "VALIDATING", "VALIDATED", "VALIDATION_FAILED", "UPDATING", "ALLOCATED", "TERMINATING", "TERMINATED", "FAILED", "NEEDS_ATTENTION" - - :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 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. @@ -30964,38 +35373,34 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataDbSystemMigration` :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_exadata_db_system_resource_model API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'compartmentId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks" - method = "GET" - operation_name = "list_vm_cluster_networks" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/ListVmClusterNetworks" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/actions/migration" + method = "POST" + operation_name = "migrate_exadata_db_system_resource_model" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/MigrateExadataDbSystemResourceModel" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "opc_request_id" + "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( - f"list_vm_cluster_networks got unknown kwargs: {extra_kwargs!r}") + f"migrate_exadata_db_system_resource_model got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -31004,42 +35409,12 @@ 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(f'Parameter {k} cannot be None, whitespace or empty string') - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { 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( - f"Invalid value for `sort_order`, must be one of { 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", "NEEDS_ATTENTION"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { 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", - "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), + "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} @@ -31050,6 +35425,7 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31057,9 +35433,8 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[VmClusterNetworkSummary]", + response_type="ExadataDbSystemMigration", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31069,29 +35444,42 @@ def list_vm_cluster_networks(self, exadata_infrastructure_id, compartment_id, ** resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="list[VmClusterNetworkSummary]", + response_type="ExadataDbSystemMigration", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): + def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): """ - Gets the history of the patch actions performed on the specified VM cluster in an Exadata Cloud@Customer system. + 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 - :param str vm_cluster_id: (required) - The VM cluster `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 oci.database.models.MigrateVaultKeyDetails migrate_vault_key_details: (required) + Request to change the source of the encryption key for the database. - :param str page: (optional) - The pagination token to continue listing from. + :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. @@ -31105,33 +35493,34 @@ def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.Database` :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 migrate_vault_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/patchHistoryEntries" - method = "GET" - operation_name = "list_vm_cluster_patch_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PatchHistoryEntry/ListVmClusterPatchHistoryEntries" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/migrateKey" + method = "POST" + operation_name = "migrate_vault_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/MigrateVaultKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page" + "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( - f"list_vm_cluster_patch_history_entries got unknown kwargs: {extra_kwargs!r}") + f"migrate_vault_key got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -31140,16 +35529,14 @@ 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(f'Parameter {k} cannot be None, whitespace or empty string') - 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), + "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} retry_strategy = self.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -31158,6 +35545,7 @@ def list_vm_cluster_patch_history_entries(self, vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31165,9 +35553,9 @@ 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=migrate_vault_key_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31177,29 +35565,41 @@ 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=migrate_vault_key_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): + def modify_database_management(self, database_id, modify_database_management_details, **kwargs): """ - Lists the patches applicable to the specified VM cluster in an Exadata Cloud@Customer system. + Updates one or more attributes of the Database Management service for the database. - :param str vm_cluster_id: (required) - The VM cluster `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 oci.database.models.ModifyDatabaseManagementDetails modify_database_management_details: (required) + The data to update one or more attributes of the Database Management Service for the database. - :param str page: (optional) - The pagination token to continue listing from. + :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. @@ -31213,33 +35613,34 @@ def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :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 modify_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/patches" - method = "GET" - operation_name = "list_vm_cluster_patches" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Patch/ListVmClusterPatches" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/modifyDatabaseManagement" + method = "POST" + operation_name = "modify_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ModifyDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "limit", - "page" + "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( - f"list_vm_cluster_patches got unknown kwargs: {extra_kwargs!r}") + f"modify_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -31248,16 +35649,14 @@ 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(f'Parameter {k} cannot be None, whitespace or empty string') - 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-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.base_client.get_preferred_retry_strategy( operation_retry_strategy=kwargs.get('retry_strategy'), @@ -31266,6 +35665,7 @@ def list_vm_cluster_patches(self, vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31273,9 +35673,9 @@ 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]", + body=modify_database_management_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31285,43 +35685,42 @@ 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]", + body=modify_database_management_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_cluster_update_history_entries(self, vm_cluster_id, **kwargs): + def modify_pluggable_database_management(self, pluggable_database_id, modify_pluggable_database_management_details, **kwargs): """ - Gets the history of the maintenance update actions performed on the specified VM cluster. Applies to Exadata Cloud@Customer instances only. + Updates one or more attributes of the Database Management service for the pluggable database. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str pluggable_database_id: (required) + The database `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 str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "IN_PROGRESS", "SUCCEEDED", "FAILED" - - :param int limit: (optional) - The maximum number of items to return per page. + :param oci.database.models.ModifyPluggableDatabaseManagementDetails modify_pluggable_database_management_details: (required) + The data to update one or more attributes of the Database Management Service for the pluggable database. - :param str page: (optional) - The pagination token to continue listing from. + :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. @@ -31334,36 +35733,34 @@ def list_vm_cluster_update_history_entries(self, vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterUpdateHistoryEntrySummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_cluster_update_history_entries API. + Click `here `__ to see an example of how to use modify_pluggable_database_management API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/updateHistoryEntries" - method = "GET" - operation_name = "list_vm_cluster_update_history_entries" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdateHistoryEntry/ListVmClusterUpdateHistoryEntries" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/modifyPluggableDatabaseManagement" + method = "POST" + operation_name = "modify_pluggable_database_management" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ModifyPluggableDatabaseManagement" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "update_type", - "lifecycle_state", - "limit", - "page", - "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( - f"list_vm_cluster_update_history_entries got unknown kwargs: {extra_kwargs!r}") + f"modify_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") path_params = { - "vmClusterId": vm_cluster_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -31372,32 +35769,12 @@ def list_vm_cluster_update_history_entries(self, vm_cluster_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - 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( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["IN_PROGRESS", "SUCCEEDED", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) - - query_params = { - "updateType": kwargs.get("update_type", missing), - "lifecycleState": kwargs.get("lifecycle_state", 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) + "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} @@ -31408,6 +35785,7 @@ def list_vm_cluster_update_history_entries(self, vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31415,9 +35793,9 @@ def list_vm_cluster_update_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[VmClusterUpdateHistoryEntrySummary]", + body=modify_pluggable_database_management_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31427,43 +35805,42 @@ def list_vm_cluster_update_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[VmClusterUpdateHistoryEntrySummary]", + body=modify_pluggable_database_management_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_cluster_updates(self, vm_cluster_id, **kwargs): + def move_execution_action_member(self, execution_action_id, move_execution_action_member_details, **kwargs): """ - Lists the maintenance updates that can be applied to the specified VM cluster. Applies to Exadata Cloud@Customer instances only. + Moves an execution action member to this execution action resource from another. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str execution_action_id: (required) + The execution action `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 str lifecycle_state: (optional) - A filter to return only resources that match the given lifecycle state exactly. - - Allowed values are: "AVAILABLE", "SUCCESS", "IN_PROGRESS", "FAILED" - - :param int limit: (optional) - The maximum number of items to return per page. + :param oci.database.models.MoveExecutionActionMemberDetails move_execution_action_member_details: (required) + Request to move an execution action member to this execution action resource from another. - :param str page: (optional) - The pagination token to continue listing from. + :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. @@ -31476,70 +35853,48 @@ def list_vm_cluster_updates(self, vm_cluster_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.database.models.VmClusterUpdateSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExecutionAction` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use list_vm_cluster_updates API. + Click `here `__ to see an example of how to use move_execution_action_member API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/updates" - method = "GET" - operation_name = "list_vm_cluster_updates" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterUpdate/ListVmClusterUpdates" + required_arguments = ['executionActionId'] + resource_path = "/executionActions/{executionActionId}/actions/moveActionMember" + method = "POST" + operation_name = "move_execution_action_member" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/MoveExecutionActionMember" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "update_type", - "lifecycle_state", - "limit", - "page", - "opc_request_id" + "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( - f"list_vm_cluster_updates got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') - - 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( - f"Invalid value for `update_type`, must be one of { update_type_allowed_values }" - ) - - if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["AVAILABLE", "SUCCESS", "IN_PROGRESS", "FAILED"] - if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: - raise ValueError( - f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" - ) - - query_params = { - "updateType": kwargs.get("update_type", missing), - "lifecycleState": kwargs.get("lifecycle_state", missing), - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + raise ValueError( + f"move_execution_action_member got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "executionActionId": execution_action_id } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -31550,6 +35905,7 @@ def list_vm_cluster_updates(self, vm_cluster_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31557,9 +35913,9 @@ def list_vm_cluster_updates(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[VmClusterUpdateSummary]", + body=move_execution_action_member_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31569,55 +35925,39 @@ def list_vm_cluster_updates(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[VmClusterUpdateSummary]", + body=move_execution_action_member_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def list_vm_clusters(self, compartment_id, **kwargs): + def refresh_pluggable_database(self, pluggable_database_id, **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. + Refreshes a pluggable database (PDB) Refreshable clone. - :param str compartment_id: (required) - The compartment `OCID`__. + :param str pluggable_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. - - 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 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. @@ -31630,74 +35970,48 @@ def list_vm_clusters(self, compartment_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :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 refresh_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['compartmentId'] - resource_path = "/vmClusters" - method = "GET" - operation_name = "list_vm_clusters" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/ListVmClusters" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/refresh" + method = "POST" + operation_name = "refresh_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RefreshPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "exadata_infrastructure_id", - "limit", - "page", - "sort_by", - "sort_order", - "lifecycle_state", - "display_name", - "opc_request_id" + "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( - f"list_vm_clusters got unknown kwargs: {extra_kwargs!r}") - - if 'sort_by' in kwargs: - sort_by_allowed_values = ["TIMECREATED", "DISPLAYNAME"] - if kwargs['sort_by'] not in sort_by_allowed_values: - raise ValueError( - f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" - ) + f"refresh_pluggable_database got unknown kwargs: {extra_kwargs!r}") - if 'sort_order' in kwargs: - sort_order_allowed_values = ["ASC", "DESC"] - if kwargs['sort_order'] not in sort_order_allowed_values: - raise ValueError( - f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" - ) + path_params = { + "pluggableDatabaseId": pluggable_database_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( - f"Invalid value for `lifecycle_state`, must be one of { 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(f'Parameter {k} cannot be None, whitespace or empty string') 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-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} @@ -31708,15 +36022,16 @@ def list_vm_clusters(self, compartment_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( 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]", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31725,42 +36040,29 @@ def list_vm_clusters(self, compartment_id, **kwargs): 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]", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def local_clone_pluggable_database(self, local_clone_pluggable_database_details, pluggable_database_id, **kwargs): + def register_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): """ - **Deprecated.** Use :func:`create_pluggable_database` for Pluggable Database LocalClone Operation. - Clones and starts a pluggable database (PDB) in the same database (CDB) as the source PDB. The source PDB must be in the `READ_WRITE` openMode to perform the clone operation. - + Asynchronously registers this Autonomous Database with Data Safe. - :param oci.database.models.LocalClonePluggableDatabaseDetails local_clone_pluggable_database_details: (required) - Request to clone a pluggable database locally. - :param str pluggable_database_id: (required) + :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_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 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. @@ -31774,34 +36076,33 @@ def local_clone_pluggable_database(self, local_clone_pluggable_database_details, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 local_clone_pluggable_database API. + Click `here `__ to see an example of how to use register_autonomous_database_data_safe API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/localClone" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/registerDataSafe" method = "POST" - operation_name = "local_clone_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/LocalClonePluggableDatabase" + operation_name = "register_autonomous_database_data_safe" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RegisterAutonomousDatabaseDataSafe" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", "opc_request_id", - "opc_retry_token" + "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( - f"local_clone_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"register_autonomous_database_data_safe got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -31813,9 +36114,7 @@ def local_clone_pluggable_database(self, local_clone_pluggable_database_details, 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) + "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} @@ -31826,7 +36125,6 @@ def local_clone_pluggable_database(self, local_clone_pluggable_database_details, if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31835,8 +36133,7 @@ def local_clone_pluggable_database(self, local_clone_pluggable_database_details, method=method, path_params=path_params, header_params=header_params, - body=local_clone_pluggable_database_details, - response_type="PluggableDatabase", + body=kwargs.get('register_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31847,41 +36144,32 @@ def local_clone_pluggable_database(self, local_clone_pluggable_database_details, method=method, path_params=path_params, header_params=header_params, - body=local_clone_pluggable_database_details, - response_type="PluggableDatabase", + body=kwargs.get('register_autonomous_database_data_safe_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): + def reinstate_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Migrates the Exadata DB system to the new `Exadata resource model`__. - All related resources will be migrated. - - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby 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 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 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. @@ -31894,34 +36182,33 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabaseDataguardAssociation` :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 reinstate_autonomous_container_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/actions/migration" + required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/reinstate" method = "POST" - operation_name = "migrate_exadata_db_system_resource_model" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/MigrateExadataDbSystemResourceModel" + operation_name = "reinstate_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/ReinstateAutonomousContainerDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id", - "if_match", - "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( - f"migrate_exadata_db_system_resource_model got unknown kwargs: {extra_kwargs!r}") + f"reinstate_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_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} @@ -31933,9 +36220,7 @@ 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) + "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} @@ -31946,7 +36231,6 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -31955,7 +36239,7 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadataDbSystemMigration", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -31966,17 +36250,15 @@ def migrate_exadata_db_system_resource_model(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="ExadataDbSystemMigration", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): + def reinstate_data_guard_association(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, **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 + Reinstates the database identified by the `databaseId` parameter into the standby role in a Data Guard association. :param str database_id: (required) @@ -31984,24 +36266,19 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): __ 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 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 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. @@ -32014,34 +36291,33 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DataGuardAssociation` :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 reinstate_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/migrateKey" + required_arguments = ['databaseId', 'dataGuardAssociationId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/reinstate" method = "POST" - operation_name = "migrate_vault_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/MigrateVaultKey" + operation_name = "reinstate_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/ReinstateDataGuardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"migrate_vault_key got unknown kwargs: {extra_kwargs!r}") + f"reinstate_data_guard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": 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} @@ -32053,9 +36329,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} @@ -32066,7 +36340,6 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -32075,8 +36348,8 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=migrate_vault_key_details, - response_type="Database", + body=reinstate_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32087,25 +36360,35 @@ def migrate_vault_key(self, database_id, migrate_vault_key_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=migrate_vault_key_details, - response_type="Database", + body=reinstate_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def modify_database_management(self, database_id, modify_database_management_details, **kwargs): + def remote_clone_pluggable_database(self, remote_clone_pluggable_database_details, pluggable_database_id, **kwargs): """ - Updates one or more attributes of the Database Management service for the database. + **Deprecated.** Use :func:`create_pluggable_database` for Pluggable Database RemoteClone Operation. + Clones a pluggable database (PDB) to a different database from the source PDB. The cloned PDB will be started upon completion of the clone operation. The source PDB must be in the `READ_WRITE` openMode when performing the clone. + For Exadata Cloud@Customer instances, the source pluggable database (PDB) must be on the same Exadata Infrastructure as the target container database (CDB) to create a remote clone. - :param str database_id: (required) + :param oci.database.models.RemoteClonePluggableDatabaseDetails remote_clone_pluggable_database_details: (required) + Request to clone a pluggable database (PDB) to a different database (CDB) from the source PDB. + + :param str pluggable_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ModifyDatabaseManagementDetails modify_database_management_details: (required) - The data to update one or more attributes of the Database Management Service 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_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 @@ -32114,14 +36397,6 @@ def modify_database_management(self, database_id, modify_database_management_det 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. @@ -32134,34 +36409,34 @@ def modify_database_management(self, database_id, modify_database_management_det allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use modify_database_management API. + Click `here `__ to see an example of how to use remote_clone_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/modifyDatabaseManagement" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/remoteClone" method = "POST" - operation_name = "modify_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/ModifyDatabaseManagement" + operation_name = "remote_clone_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RemoteClonePluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", + "if_match", "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( - f"modify_database_management got unknown kwargs: {extra_kwargs!r}") + f"remote_clone_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32173,9 +36448,9 @@ def modify_database_management(self, database_id, modify_database_management_det 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-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} @@ -32195,8 +36470,8 @@ def modify_database_management(self, database_id, modify_database_management_det method=method, path_params=path_params, header_params=header_params, - body=modify_database_management_details, - response_type="Database", + body=remote_clone_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32207,25 +36482,25 @@ def modify_database_management(self, database_id, modify_database_management_det method=method, path_params=path_params, header_params=header_params, - body=modify_database_management_details, - response_type="Database", + body=remote_clone_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def modify_pluggable_database_management(self, pluggable_database_id, modify_pluggable_database_management_details, **kwargs): + def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **kwargs): """ - Updates one or more attributes of the Database Management service for the pluggable database. + Remove Virtual Machines from the Cloud VM cluster. Applies to Exadata Cloud instances only. - :param str pluggable_database_id: (required) - The database `OCID`__. + :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) + Request to remove Virtual Machines from the Cloud VM cluster. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param str cloud_vm_cluster_id: (required) + The cloud VM cluster `OCID`__. - :param oci.database.models.ModifyPluggableDatabaseManagementDetails modify_pluggable_database_management_details: (required) - The data to update one or more attributes of the Database Management Service for the pluggable 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 @@ -32254,18 +36529,18 @@ def modify_pluggable_database_management(self, pluggable_database_id, modify_plu allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 modify_pluggable_database_management API. + Click `here `__ to see an example of how to use remove_virtual_machine_from_cloud_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/modifyPluggableDatabaseManagement" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/removeVirtualMachine" method = "POST" - operation_name = "modify_pluggable_database_management" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/ModifyPluggableDatabaseManagement" + operation_name = "remove_virtual_machine_from_cloud_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/RemoveVirtualMachineFromCloudVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -32278,10 +36553,10 @@ def modify_pluggable_database_management(self, pluggable_database_id, modify_plu extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"modify_pluggable_database_management got unknown kwargs: {extra_kwargs!r}") + f"remove_virtual_machine_from_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32315,8 +36590,8 @@ def modify_pluggable_database_management(self, pluggable_database_id, modify_plu method=method, path_params=path_params, header_params=header_params, - body=modify_pluggable_database_management_details, - response_type="PluggableDatabase", + body=remove_virtual_machine_from_cloud_vm_cluster_details, + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32327,30 +36602,25 @@ def modify_pluggable_database_management(self, pluggable_database_id, modify_plu method=method, path_params=path_params, header_params=header_params, - body=modify_pluggable_database_management_details, - response_type="PluggableDatabase", + body=remove_virtual_machine_from_cloud_vm_cluster_details, + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def refresh_pluggable_database(self, pluggable_database_id, **kwargs): + def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **kwargs): """ - Refreshes a pluggable database (PDB) Refreshable clone. - + Remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Cloud instances only. - :param str pluggable_database_id: (required) - The database `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) + Request to remove Virtual Machines from the Exadata VM cluster on Exascale 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 exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. - :param str opc_request_id: (optional) - Unique identifier for the request. + __ 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 @@ -32359,6 +36629,14 @@ def refresh_pluggable_database(self, pluggable_database_id, **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 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. @@ -32371,34 +36649,34 @@ def refresh_pluggable_database(self, pluggable_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use refresh_pluggable_database API. + Click `here `__ to see an example of how to use remove_virtual_machine_from_exadb_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/refresh" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}/actions/removeVirtualMachine" method = "POST" - operation_name = "refresh_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RefreshPluggableDatabase" + operation_name = "remove_virtual_machine_from_exadb_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/RemoveVirtualMachineFromExadbVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", + "opc_retry_token", "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( - f"refresh_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"remove_virtual_machine_from_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32410,9 +36688,9 @@ def refresh_pluggable_database(self, pluggable_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-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} @@ -32432,7 +36710,8 @@ def refresh_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", + body=remove_virtual_machine_from_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32443,27 +36722,40 @@ def refresh_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", + body=remove_virtual_machine_from_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def register_autonomous_database_data_safe(self, autonomous_database_id, **kwargs): + def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **kwargs): """ - Asynchronously registers this Autonomous Database with Data Safe. + Remove Virtual Machines from the VM cluster. Applies to Exadata Cloud@Customer instances only. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) + Request to remove Virtual Machines from the VM cluster. + + :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 + 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 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. @@ -32477,33 +36769,34 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 register_autonomous_database_data_safe API. + Click `here `__ to see an example of how to use remove_virtual_machine_from_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/registerDataSafe" + required_arguments = ['vmClusterId'] + resource_path = "/vmClusters/{vmClusterId}/actions/removeVirtualMachine" method = "POST" - operation_name = "register_autonomous_database_data_safe" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RegisterAutonomousDatabaseDataSafe" + operation_name = "remove_virtual_machine_from_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/RemoveVirtualMachineFromVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "opc_retry_token", "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( - f"register_autonomous_database_data_safe got unknown kwargs: {extra_kwargs!r}") + f"remove_virtual_machine_from_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "vmClusterId": vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32515,7 +36808,9 @@ 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) + "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} @@ -32526,6 +36821,7 @@ def register_autonomous_database_data_safe(self, autonomous_database_id, **kwarg if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -32534,7 +36830,8 @@ 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=remove_virtual_machine_from_vm_cluster_details, + response_type="VmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32545,32 +36842,41 @@ 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=remove_virtual_machine_from_vm_cluster_details, + response_type="VmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def reinstate_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): + def reorder_execution_actions(self, execution_window_id, reorder_execution_action_details, **kwargs): """ - Reinstates a disabled standby Autonomous Container Database, identified by the autonomousContainerDatabaseId parameter, to an active standby Autonomous Container Database. + Reorders the execution actions under this execution window resource. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str execution_window_id: (required) + The execution window `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.ReorderExecutionActionDetails reorder_execution_action_details: (required) + Request to reorder the execution actions under this execution window 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 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. @@ -32583,33 +36889,34 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionWindow` :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 reorder_execution_actions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/reinstate" + required_arguments = ['executionWindowId'] + resource_path = "/executionWindows/{executionWindowId}/actions/reorder" method = "POST" - operation_name = "reinstate_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/ReinstateAutonomousContainerDatabaseDataguardAssociation" + operation_name = "reorder_execution_actions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/ReorderExecutionActions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match" + "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( - f"reinstate_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"reorder_execution_actions got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "executionWindowId": execution_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32621,7 +36928,9 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo 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), + "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} @@ -32632,6 +36941,7 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -32640,7 +36950,8 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=reorder_execution_action_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32651,29 +36962,35 @@ def reinstate_autonomous_container_database_dataguard_association(self, autonomo method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=reorder_execution_action_details, + response_type="ExecutionWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def reinstate_data_guard_association(self, database_id, data_guard_association_id, reinstate_data_guard_association_details, **kwargs): + def reorder_scheduled_actions(self, reorder_scheduled_actions_details, scheduling_plan_id, **kwargs): """ - Reinstates the database identified by the `databaseId` parameter into the standby role in a Data Guard association. - + Re-order the scheduled actions under this scheduling plan resource. - :param str database_id: (required) - The database `OCID`__. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.ReorderScheduledActionsDetails reorder_scheduled_actions_details: (required) + Request to re-order Scheduled Action resources. - :param str data_guard_association_id: (required) - The Data Guard association's `OCID`__. + :param str scheduling_plan_id: (required) + The Schedule Plan `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 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` @@ -32692,33 +37009,34 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SchedulingPlan` :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 reorder_scheduled_actions API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'dataGuardAssociationId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/reinstate" + required_arguments = ['schedulingPlanId'] + resource_path = "/schedulingPlans/{schedulingPlanId}/actions/reorder" method = "POST" - operation_name = "reinstate_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/ReinstateDataGuardAssociation" + operation_name = "reorder_scheduled_actions" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPlan/ReorderScheduledActions" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"reinstate_data_guard_association got unknown kwargs: {extra_kwargs!r}") + f"reorder_scheduled_actions got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "schedulingPlanId": scheduling_plan_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -32730,6 +37048,8 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i 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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -32741,6 +37061,7 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -32749,8 +37070,8 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i method=method, path_params=path_params, header_params=header_params, - body=reinstate_data_guard_association_details, - response_type="DataGuardAssociation", + body=reorder_scheduled_actions_details, + response_type="SchedulingPlan", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32761,32 +37082,31 @@ def reinstate_data_guard_association(self, database_id, data_guard_association_i method=method, path_params=path_params, header_params=header_params, - body=reinstate_data_guard_association_details, - response_type="DataGuardAssociation", + body=reorder_scheduled_actions_details, + response_type="SchedulingPlan", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def remote_clone_pluggable_database(self, remote_clone_pluggable_database_details, pluggable_database_id, **kwargs): + def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, resize_vm_cluster_network_details, **kwargs): """ - **Deprecated.** Use :func:`create_pluggable_database` for Pluggable Database RemoteClone Operation. - Clones a pluggable database (PDB) to a different database from the source PDB. The cloned PDB will be started upon completion of the clone operation. The source PDB must be in the `READ_WRITE` openMode when performing the clone. - For Exadata Cloud@Customer instances, the source pluggable database (PDB) must be on the same Exadata Infrastructure as the target container database (CDB) to create a remote clone. + Adds or removes Db server network nodes to extend or shrink the existing VM cluster network. Applies to Exadata + Cloud@Customer instances only. - :param oci.database.models.RemoteClonePluggableDatabaseDetails remote_clone_pluggable_database_details: (required) - Request to clone a pluggable database (PDB) to a different database (CDB) from the source PDB. + :param str exadata_infrastructure_id: (required) + The Exadata infrastructure `OCID`__. - :param str pluggable_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`__. __ 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.ResizeVmClusterNetworkDetails resize_vm_cluster_network_details: (required) + Request to add or remove Db server network nodes in the VM cluster network. :param str opc_request_id: (optional) Unique identifier for the request. @@ -32798,6 +37118,11 @@ def remote_clone_pluggable_database(self, remote_clone_pluggable_database_detail 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. @@ -32810,34 +37135,35 @@ def remote_clone_pluggable_database(self, remote_clone_pluggable_database_detail allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 remote_clone_pluggable_database API. + Click `here `__ to see an example of how to use resize_vm_cluster_network API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/remoteClone" + required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/resize" method = "POST" - operation_name = "remote_clone_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RemoteClonePluggableDatabase" + operation_name = "resize_vm_cluster_network" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/ResizeVmClusterNetwork" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", "opc_request_id", - "opc_retry_token" + "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( - f"remote_clone_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"resize_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_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} @@ -32849,9 +37175,9 @@ def remote_clone_pluggable_database(self, remote_clone_pluggable_database_detail 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) + "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} @@ -32871,8 +37197,8 @@ def remote_clone_pluggable_database(self, remote_clone_pluggable_database_detail method=method, path_params=path_params, header_params=header_params, - body=remote_clone_pluggable_database_details, - response_type="PluggableDatabase", + body=resize_vm_cluster_network_details, + response_type="VmClusterNetwork", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -32883,25 +37209,22 @@ def remote_clone_pluggable_database(self, remote_clone_pluggable_database_detail method=method, path_params=path_params, header_params=header_params, - body=remote_clone_pluggable_database_details, - response_type="PluggableDatabase", + body=resize_vm_cluster_network_details, + response_type="VmClusterNetwork", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **kwargs): + def resource_pool_shapes(self, **kwargs): """ - Remove Virtual Machines from the Cloud VM cluster. Applies to Exadata Cloud instances only. - - - :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) - Request to remove Virtual Machines from the Cloud VM cluster. + Lists available resource pools shapes. - :param str cloud_vm_cluster_id: (required) - The cloud 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_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -32910,14 +37233,15 @@ def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_fr has been deleted and purged from the system, then a retry of the original creation request may be rejected). + :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 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. @@ -32930,48 +37254,46 @@ def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_fr allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ResourcePoolShapeCollection` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use remove_virtual_machine_from_cloud_vm_cluster API. + Click `here `__ to see an example of how to use resource_pool_shapes API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/actions/removeVirtualMachine" + required_arguments = [] + resource_path = "/autonomousDatabases/actions/listResourcePoolShapes" method = "POST" - operation_name = "remove_virtual_machine_from_cloud_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/RemoveVirtualMachineFromCloudVmCluster" + operation_name = "resource_pool_shapes" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ResourcePoolShapes" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "if_match", "opc_retry_token", - "opc_request_id", - "if_match" + "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( - f"remove_virtual_machine_from_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"resource_pool_shapes got unknown kwargs: {extra_kwargs!r}") - path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + query_params = { + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing) } - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + 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), - "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} @@ -32989,10 +37311,9 @@ def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_fr self.base_client.call_api, resource_path=resource_path, method=method, - path_params=path_params, + query_params=query_params, header_params=header_params, - body=remove_virtual_machine_from_cloud_vm_cluster_details, - response_type="CloudVmCluster", + response_type="ResourcePoolShapeCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33001,43 +37322,32 @@ def remove_virtual_machine_from_cloud_vm_cluster(self, remove_virtual_machine_fr return self.base_client.call_api( resource_path=resource_path, method=method, - path_params=path_params, + query_params=query_params, header_params=header_params, - body=remove_virtual_machine_from_cloud_vm_cluster_details, - response_type="CloudVmCluster", + response_type="ResourcePoolShapeCollection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **kwargs): + def restart_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Cloud instances only. - + Rolling restarts the specified Autonomous Container Database. - :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) - Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :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_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 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. @@ -33050,34 +37360,33 @@ def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_fr allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` + :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 remove_virtual_machine_from_exadb_vm_cluster API. + Click `here `__ to see an example of how to use restart_autonomous_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}/actions/removeVirtualMachine" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/restart" method = "POST" - operation_name = "remove_virtual_machine_from_exadb_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/RemoveVirtualMachineFromExadbVmCluster" + operation_name = "restart_autonomous_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/RestartAutonomousContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_retry_token", - "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( - f"remove_virtual_machine_from_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"restart_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -33089,9 +37398,8 @@ def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_fr 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) + "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} @@ -33102,7 +37410,6 @@ def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_fr if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33111,8 +37418,7 @@ def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_fr method=method, path_params=path_params, header_params=header_params, - body=remove_virtual_machine_from_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33123,36 +37429,22 @@ def remove_virtual_machine_from_exadb_vm_cluster(self, remove_virtual_machine_fr method=method, path_params=path_params, header_params=header_params, - body=remove_virtual_machine_from_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + response_type="AutonomousContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **kwargs): + def restart_autonomous_database(self, autonomous_database_id, **kwargs): """ - Remove Virtual Machines from the VM cluster. Applies to Exadata Cloud@Customer instances only. - + Restarts the specified Autonomous Database. - :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) - Request to remove Virtual Machines from the VM cluster. - :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 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 @@ -33170,34 +37462,32 @@ def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use remove_virtual_machine_from_vm_cluster API. + Click `here `__ to see an example of how to use restart_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['vmClusterId'] - resource_path = "/vmClusters/{vmClusterId}/actions/removeVirtualMachine" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restart" method = "POST" - operation_name = "remove_virtual_machine_from_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmCluster/RemoveVirtualMachineFromVmCluster" + operation_name = "restart_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RestartAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"remove_virtual_machine_from_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"restart_autonomous_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -33209,8 +37499,6 @@ def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_ 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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -33222,7 +37510,6 @@ def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33231,8 +37518,7 @@ def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_ method=method, path_params=path_params, header_params=header_params, - body=remove_virtual_machine_from_vm_cluster_details, - response_type="VmCluster", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33243,41 +37529,24 @@ def remove_virtual_machine_from_vm_cluster(self, remove_virtual_machine_from_vm_ method=method, path_params=path_params, header_params=header_params, - body=remove_virtual_machine_from_vm_cluster_details, - response_type="VmCluster", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_network_id, resize_vm_cluster_network_details, **kwargs): + def restore_autonomous_database(self, autonomous_database_id, restore_autonomous_database_details, **kwargs): """ - Adds or removes Db server network nodes to extend or shrink the existing VM cluster network. Applies to Exadata - Cloud@Customer instances only. - - - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + Restores an Autonomous Database based on the provided request parameters. - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str vm_cluster_network_id: (required) - The VM cluster network `OCID`__. + :param str autonomous_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.ResizeVmClusterNetworkDetails resize_vm_cluster_network_details: (required) - Request to add or remove Db server network nodes in the VM cluster network. - - :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 oci.database.models.RestoreAutonomousDatabaseDetails restore_autonomous_database_details: (required) + Request to perform an Autonomous Database restore. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -33296,35 +37565,32 @@ def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use resize_vm_cluster_network API. + Click `here `__ to see an example of how to use restore_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId', 'vmClusterNetworkId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}/vmClusterNetworks/{vmClusterNetworkId}/actions/resize" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restore" method = "POST" - operation_name = "resize_vm_cluster_network" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/VmClusterNetwork/ResizeVmClusterNetwork" + operation_name = "restore_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RestoreAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"resize_vm_cluster_network got unknown kwargs: {extra_kwargs!r}") + f"restore_autonomous_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id, - "vmClusterNetworkId": vm_cluster_network_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -33336,8 +37602,6 @@ def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ 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} @@ -33349,7 +37613,6 @@ def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33358,8 +37621,8 @@ def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ method=method, path_params=path_params, header_params=header_params, - body=resize_vm_cluster_network_details, - response_type="VmClusterNetwork", + body=restore_autonomous_database_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33370,39 +37633,31 @@ def resize_vm_cluster_network(self, exadata_infrastructure_id, vm_cluster_networ method=method, path_params=path_params, header_params=header_params, - body=resize_vm_cluster_network_details, - response_type="VmClusterNetwork", + body=restore_autonomous_database_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def resource_pool_shapes(self, **kwargs): + def restore_database(self, database_id, restore_database_details, **kwargs): """ - Lists available resource pools shapes. + Restore a Database based on the request parameters you provide. + + + :param str database_id: (required) + The database `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` 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 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. @@ -33415,46 +37670,44 @@ def resource_pool_shapes(self, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ResourcePoolShapeCollection` + :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 resource_pool_shapes API. + Click `here `__ to see an example of how to use restore_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabases/actions/listResourcePoolShapes" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/restore" method = "POST" - operation_name = "resource_pool_shapes" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ResourcePoolShapes" + operation_name = "restore_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/RestoreDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "opc_retry_token", - "limit", - "page", - "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( - f"resource_pool_shapes got unknown kwargs: {extra_kwargs!r}") + f"restore_database got unknown kwargs: {extra_kwargs!r}") - query_params = { - "limit": kwargs.get("limit", missing), - "page": kwargs.get("page", missing) + path_params = { + "databaseId": database_id } - query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -33465,16 +37718,16 @@ def resource_pool_shapes(self, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( 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="ResourcePoolShapeCollection", + body=restore_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33483,17 +37736,20 @@ def resource_pool_shapes(self, **kwargs): 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="ResourcePoolShapeCollection", + body=restore_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def restart_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def rotate_autonomous_container_database_encryption_key(self, autonomous_container_database_id, **kwargs): """ - Rolling restarts the specified Autonomous Container Database. + Creates a new version of an existing `Vault service`__ key. + + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm :param str autonomous_container_database_id: (required) @@ -33506,6 +37762,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. @@ -33525,26 +37788,27 @@ def restart_autonomous_container_database(self, autonomous_container_database_id :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_container_database_encryption_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/restart" + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/rotateKey" method = "POST" - operation_name = "restart_autonomous_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/RestartAutonomousContainerDatabase" + operation_name = "rotate_autonomous_container_database_encryption_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/RotateAutonomousContainerDatabaseEncryptionKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"restart_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") + f"rotate_autonomous_container_database_encryption_key got unknown kwargs: {extra_kwargs!r}") path_params = { "autonomousContainerDatabaseId": autonomous_container_database_id @@ -33560,6 +37824,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} @@ -33571,6 +37836,7 @@ def restart_autonomous_container_database(self, autonomous_container_database_id if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33596,9 +37862,11 @@ def restart_autonomous_container_database(self, autonomous_container_database_id api_reference_link=api_reference_link, required_arguments=required_arguments) - def restart_autonomous_database(self, autonomous_database_id, **kwargs): + def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kwargs): """ - Restarts the specified Autonomous Database. + Rotate existing AutonomousDatabase `Vault service`__ key. + + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm :param str autonomous_database_id: (required) @@ -33611,6 +37879,16 @@ def restart_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. @@ -33627,25 +37905,27 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): :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_autonomous_database_encryption_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restart" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/rotateKey" method = "POST" - operation_name = "restart_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RestartAutonomousDatabase" + operation_name = "rotate_autonomous_database_encryption_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RotateAutonomousDatabaseEncryptionKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"restart_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"rotate_autonomous_database_encryption_key got unknown kwargs: {extra_kwargs!r}") path_params = { "autonomousDatabaseId": autonomous_database_id @@ -33660,7 +37940,9 @@ def restart_autonomous_database(self, autonomous_database_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-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} @@ -33671,6 +37953,7 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33696,18 +37979,28 @@ def restart_autonomous_database(self, autonomous_database_id, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) - def restore_autonomous_database(self, autonomous_database_id, restore_autonomous_database_details, **kwargs): + def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_ords_certs_details, autonomous_vm_cluster_id, **kwargs): """ - Restores an Autonomous Database based on the provided request parameters. + Rotates the Oracle REST Data Services (ORDS) certificates for Autonomous Exadata VM cluster. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param oci.database.models.RotateAutonomousVmClusterOrdsCertsDetails rotate_autonomous_vm_cluster_ords_certs_details: (required) + Request to rotate the Oracle REST Data Services (ORDS) certificates on Autonomous Exadata VM cluster. + + :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.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` @@ -33726,32 +38019,34 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_autonomous_vm_cluster_ords_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/restore" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/rotateOrdsCerts" method = "POST" - operation_name = "restore_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RestoreAutonomousDatabase" + operation_name = "rotate_autonomous_vm_cluster_ords_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/RotateAutonomousVmClusterOrdsCerts" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"restore_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"rotate_autonomous_vm_cluster_ords_certs got unknown kwargs: {extra_kwargs!r}") 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} @@ -33763,6 +38058,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} @@ -33774,6 +38071,7 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33782,8 +38080,7 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous method=method, path_params=path_params, header_params=header_params, - body=restore_autonomous_database_details, - response_type="AutonomousDatabase", + body=rotate_autonomous_vm_cluster_ords_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33794,25 +38091,34 @@ def restore_autonomous_database(self, autonomous_database_id, restore_autonomous method=method, path_params=path_params, header_params=header_params, - body=restore_autonomous_database_details, - response_type="AutonomousDatabase", + body=rotate_autonomous_vm_cluster_ords_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def restore_database(self, database_id, restore_database_details, **kwargs): + def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ssl_certs_details, autonomous_vm_cluster_id, **kwargs): """ - Restore a Database based on the request parameters you provide. + Rotates the SSL certificates for Autonomous Exadata VM cluster. - :param str database_id: (required) - The database `OCID`__. + :param oci.database.models.RotateAutonomousVmClusterSslCertsDetails rotate_autonomous_vm_cluster_ssl_certs_details: (required) + Request to rotate the SSL certificates on Autonomous Exadata VM cluster. + + :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.RestoreDatabaseDetails restore_database_details: (required) - Request to perform 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` @@ -33831,32 +38137,34 @@ def restore_database(self, database_id, restore_database_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 None :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_autonomous_vm_cluster_ssl_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/restore" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/rotateSslCerts" method = "POST" - operation_name = "restore_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/RestoreDatabase" + operation_name = "rotate_autonomous_vm_cluster_ssl_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/RotateAutonomousVmClusterSslCerts" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"restore_database got unknown kwargs: {extra_kwargs!r}") + f"rotate_autonomous_vm_cluster_ssl_certs got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id + "autonomousVmClusterId": autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -33868,6 +38176,8 @@ def restore_database(self, database_id, restore_database_details, **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} @@ -33879,6 +38189,7 @@ def restore_database(self, database_id, restore_database_details, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -33887,8 +38198,7 @@ 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", + body=rotate_autonomous_vm_cluster_ssl_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -33899,29 +38209,24 @@ 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", + body=rotate_autonomous_vm_cluster_ssl_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_autonomous_container_database_encryption_key(self, autonomous_container_database_id, **kwargs): + def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - Creates a new version of an existing `Vault service`__ key. - - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + Rotates the Oracle REST Data Services (ORDS) certificates for a cloud Autonomous Exadata VM cluster. - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + :param str cloud_autonomous_vm_cluster_id: (required) + The Cloud 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 oci.database.models.RotateCloudAutonomousVmClusterOrdsCertsDetails rotate_cloud_autonomous_vm_cluster_ords_certs_details: (optional) + Request to rotate the Oracle REST Data Services (ORDS) certificates on Cloud Autonomous Exadata 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 @@ -33933,6 +38238,11 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain :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. @@ -33945,34 +38255,35 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 rotate_cloud_autonomous_vm_cluster_ords_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/actions/rotateKey" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/rotateOrdsCerts" method = "POST" - operation_name = "rotate_autonomous_container_database_encryption_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/RotateAutonomousContainerDatabaseEncryptionKey" + operation_name = "rotate_cloud_autonomous_vm_cluster_ords_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/RotateCloudAutonomousVmClusterOrdsCerts" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", + "rotate_cloud_autonomous_vm_cluster_ords_certs_details", "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( - f"rotate_autonomous_container_database_encryption_key got unknown kwargs: {extra_kwargs!r}") + f"rotate_cloud_autonomous_vm_cluster_ords_certs got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -33984,9 +38295,9 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain 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} @@ -34006,7 +38317,7 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase", + body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ords_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34017,28 +38328,24 @@ def rotate_autonomous_container_database_encryption_key(self, autonomous_contain method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabase", + body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ords_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kwargs): + def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_cluster_id, **kwargs): """ - Rotate existing AutonomousDatabase `Vault service`__ key. - - __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm + Rotates the SSL certficates for a cloud Autonomous Exadata VM cluster. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_autonomous_vm_cluster_id: (required) + The Cloud 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 oci.database.models.RotateCloudAutonomousVmClusterSslCertsDetails rotate_cloud_autonomous_vm_cluster_ssl_certs_details: (optional) + Request to rotate the SSL certificates on Cloud Autonomous Exadata 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 @@ -34050,6 +38357,11 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw :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. @@ -34062,34 +38374,35 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 rotate_autonomous_database_encryption_key API. + Click `here `__ to see an example of how to use rotate_cloud_autonomous_vm_cluster_ssl_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/rotateKey" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/rotateSslCerts" method = "POST" - operation_name = "rotate_autonomous_database_encryption_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/RotateAutonomousDatabaseEncryptionKey" + operation_name = "rotate_cloud_autonomous_vm_cluster_ssl_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/RotateCloudAutonomousVmClusterSslCerts" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", + "rotate_cloud_autonomous_vm_cluster_ssl_certs_details", "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( - f"rotate_autonomous_database_encryption_key got unknown kwargs: {extra_kwargs!r}") + f"rotate_cloud_autonomous_vm_cluster_ssl_certs got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34101,9 +38414,9 @@ 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) + "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} @@ -34123,7 +38436,7 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ssl_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34134,22 +38447,19 @@ def rotate_autonomous_database_encryption_key(self, autonomous_database_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ssl_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_ords_certs_details, autonomous_vm_cluster_id, **kwargs): + def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Rotates the Oracle REST Data Services (ORDS) certificates for Autonomous Exadata VM cluster. - + **Deprecated.** Use the :func:`rotate_cloud_autonomous_vm_cluster_ords_certs` to rotate Oracle REST Data Services (ORDS) certs for an Autonomous Exadata VM cluster instead. - :param oci.database.models.RotateAutonomousVmClusterOrdsCertsDetails rotate_autonomous_vm_cluster_ords_certs_details: (required) - Request to rotate the Oracle REST Data Services (ORDS) certificates on Autonomous Exadata VM cluster. - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + :param str autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -34184,14 +38494,14 @@ def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_o :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_autonomous_vm_cluster_ords_certs API. + Click `here `__ to see an example of how to use rotate_ords_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/rotateOrdsCerts" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateOrdsCerts" method = "POST" - operation_name = "rotate_autonomous_vm_cluster_ords_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/RotateAutonomousVmClusterOrdsCerts" + operation_name = "rotate_ords_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/RotateOrdsCerts" # Don't accept unknown kwargs expected_kwargs = [ @@ -34204,10 +38514,10 @@ def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_o extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"rotate_autonomous_vm_cluster_ords_certs got unknown kwargs: {extra_kwargs!r}") + f"rotate_ords_certs got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34241,7 +38551,6 @@ def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_o method=method, path_params=path_params, header_params=header_params, - body=rotate_autonomous_vm_cluster_ords_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34252,25 +38561,26 @@ def rotate_autonomous_vm_cluster_ords_certs(self, rotate_autonomous_vm_cluster_o method=method, path_params=path_params, header_params=header_params, - body=rotate_autonomous_vm_cluster_ords_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ssl_certs_details, autonomous_vm_cluster_id, **kwargs): + def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwargs): """ - Rotates the SSL certificates for Autonomous Exadata VM cluster. - + Create a new version of the existing encryption key. - :param oci.database.models.RotateAutonomousVmClusterSslCertsDetails rotate_autonomous_vm_cluster_ssl_certs_details: (required) - Request to rotate the SSL certificates on Autonomous Exadata VM cluster. - :param str autonomous_vm_cluster_id: (required) - The autonomous VM cluster `OCID`__. + :param str pluggable_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_request_id: (optional) Unique identifier for the request. @@ -34281,11 +38591,6 @@ def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ss 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. @@ -34302,30 +38607,30 @@ def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ss :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_autonomous_vm_cluster_ssl_certs API. + Click `here `__ to see an example of how to use rotate_pluggable_database_encryption_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}/actions/rotateSslCerts" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/rotateKey" method = "POST" - operation_name = "rotate_autonomous_vm_cluster_ssl_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/RotateAutonomousVmClusterSslCerts" + operation_name = "rotate_pluggable_database_encryption_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RotatePluggableDatabaseEncryptionKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "if_match", "opc_request_id", - "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( - f"rotate_autonomous_vm_cluster_ssl_certs got unknown kwargs: {extra_kwargs!r}") + f"rotate_pluggable_database_encryption_key got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousVmClusterId": autonomous_vm_cluster_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34337,9 +38642,9 @@ def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ss 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) + "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} @@ -34359,7 +38664,6 @@ def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ss method=method, path_params=path_params, header_params=header_params, - body=rotate_autonomous_vm_cluster_ssl_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34370,24 +38674,23 @@ def rotate_autonomous_vm_cluster_ssl_certs(self, rotate_autonomous_vm_cluster_ss method=method, path_params=path_params, header_params=header_params, - body=rotate_autonomous_vm_cluster_ssl_certs_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_cluster_id, **kwargs): + def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): """ - Rotates the Oracle REST Data Services (ORDS) certificates for a cloud Autonomous Exadata VM cluster. + **Deprecated.** Use the :func:`rotate_cloud_autonomous_vm_cluster_ssl_certs` to rotate SSL certs for an Autonomous Exadata VM cluster instead. - :param str cloud_autonomous_vm_cluster_id: (required) - The Cloud VM cluster `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.RotateCloudAutonomousVmClusterOrdsCertsDetails rotate_cloud_autonomous_vm_cluster_ords_certs_details: (optional) - Request to rotate the Oracle REST Data Services (ORDS) certificates on Cloud Autonomous Exadata VM cluster. + :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 @@ -34396,9 +38699,6 @@ def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_clus 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 @@ -34420,31 +38720,30 @@ def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_clus :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_cloud_autonomous_vm_cluster_ords_certs API. + Click `here `__ to see an example of how to use rotate_ssl_certs API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/rotateOrdsCerts" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateSslCerts" method = "POST" - operation_name = "rotate_cloud_autonomous_vm_cluster_ords_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/RotateCloudAutonomousVmClusterOrdsCerts" + operation_name = "rotate_ssl_certs" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/RotateSslCerts" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "rotate_cloud_autonomous_vm_cluster_ords_certs_details", - "opc_retry_token", "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( - f"rotate_cloud_autonomous_vm_cluster_ords_certs got unknown kwargs: {extra_kwargs!r}") + f"rotate_ssl_certs got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34456,8 +38755,8 @@ def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_clus 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), "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} @@ -34478,7 +38777,6 @@ def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_clus method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ords_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34489,24 +38787,27 @@ def rotate_cloud_autonomous_vm_cluster_ords_certs(self, cloud_autonomous_vm_clus method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ords_certs_details'), allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_cluster_id, **kwargs): + def rotate_vault_key(self, database_id, **kwargs): """ - Rotates the SSL certficates for a cloud Autonomous Exadata VM cluster. + Creates a new version of an existing `Vault service`__ key. + __ https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm - :param str cloud_autonomous_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 oci.database.models.RotateCloudAutonomousVmClusterSslCertsDetails rotate_cloud_autonomous_vm_cluster_ssl_certs_details: (optional) - Request to rotate the SSL certificates on Cloud Autonomous Exadata 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_retry_token: (optional) A token that uniquely identifies a request so it can be retried in case of a timeout or @@ -34518,11 +38819,6 @@ def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_clust :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. @@ -34535,35 +38831,34 @@ def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_clust allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_cloud_autonomous_vm_cluster_ssl_certs API. + Click `here `__ to see an example of how to use rotate_vault_key API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}/actions/rotateSslCerts" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}/actions/rotateKey" method = "POST" - operation_name = "rotate_cloud_autonomous_vm_cluster_ssl_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/RotateCloudAutonomousVmClusterSslCerts" + operation_name = "rotate_vault_key" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/RotateVaultKey" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "rotate_cloud_autonomous_vm_cluster_ssl_certs_details", + "if_match", "opc_retry_token", - "opc_request_id", - "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( - f"rotate_cloud_autonomous_vm_cluster_ssl_certs got unknown kwargs: {extra_kwargs!r}") + f"rotate_vault_key got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34575,9 +38870,9 @@ def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_clust 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) + "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} @@ -34597,7 +38892,7 @@ def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_clust method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ssl_certs_details'), + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34608,37 +38903,25 @@ def rotate_cloud_autonomous_vm_cluster_ssl_certs(self, cloud_autonomous_vm_clust method=method, path_params=path_params, header_params=header_params, - body=kwargs.get('rotate_cloud_autonomous_vm_cluster_ssl_certs_details'), + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): + def saas_admin_user_status(self, autonomous_database_id, **kwargs): """ - **Deprecated.** Use the :func:`rotate_cloud_autonomous_vm_cluster_ords_certs` to rotate Oracle REST Data Services (ORDS) certs for an Autonomous Exadata VM cluster instead. + This operation gets SaaS administrative user status of the 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 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. @@ -34651,34 +38934,32 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.SaasAdminUserStatus` :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 saas_admin_user_status API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateOrdsCerts" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/getSaasAdminUserStatus" method = "POST" - operation_name = "rotate_ords_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/RotateOrdsCerts" + operation_name = "saas_admin_user_status" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/SaasAdminUserStatus" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"rotate_ords_certs got unknown kwargs: {extra_kwargs!r}") + f"saas_admin_user_status got unknown kwargs: {extra_kwargs!r}") 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} @@ -34690,9 +38971,7 @@ 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) + "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} @@ -34703,7 +38982,6 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -34712,6 +38990,7 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + response_type="SaasAdminUserStatus", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34722,25 +39001,28 @@ def rotate_ords_certs(self, autonomous_exadata_infrastructure_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + response_type="SaasAdminUserStatus", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwargs): + def scan_external_container_database_pluggable_databases(self, external_container_database_id, external_database_connector_id, **kwargs): """ - Create a new version of the existing encryption key. + Scans for pluggable databases in the specified external container database. + This operation will return un-registered pluggable databases in the :func:`get_work_request` operation. - :param str pluggable_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 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 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. @@ -34768,30 +39050,29 @@ def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwar :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use rotate_pluggable_database_encryption_key API. + Click `here `__ to see an example of how to use scan_external_container_database_pluggable_databases API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/rotateKey" + required_arguments = ['externalContainerDatabaseId', 'externalDatabaseConnectorId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/scanPluggableDatabases" method = "POST" - operation_name = "rotate_pluggable_database_encryption_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/RotatePluggableDatabaseEncryptionKey" + operation_name = "scan_external_container_database_pluggable_databases" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ScanExternalContainerDatabasePluggableDatabases" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"rotate_pluggable_database_encryption_key got unknown kwargs: {extra_kwargs!r}") + f"scan_external_container_database_pluggable_databases got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -34800,10 +39081,14 @@ def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwar if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + 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-request-id": kwargs.get("opc_request_id", missing), "opc-retry-token": kwargs.get("opc_retry_token", missing) } @@ -34824,6 +39109,7 @@ def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwar resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, @@ -34834,32 +39120,23 @@ def rotate_pluggable_database_encryption_key(self, pluggable_database_id, **kwar resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): + def shrink_autonomous_database(self, autonomous_database_id, **kwargs): """ - **Deprecated.** Use the :func:`rotate_cloud_autonomous_vm_cluster_ssl_certs` to rotate SSL certs for an Autonomous Exadata VM cluster instead. + This operation shrinks the current allocated storage down to the current actual used data storage (actualUsedDataStorageSizeInTBs). The if the base storage value for the database (dataStorageSizeInTBs) is larger than the actualUsedDataStorageSizeInTBs value, you are billed for the base storage value. - :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 @@ -34877,34 +39154,32 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_ssl_certs API. + Click `here `__ to see an example of how to use shrink_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}/actions/rotateSslCerts" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/shrink" method = "POST" - operation_name = "rotate_ssl_certs" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/RotateSslCerts" + operation_name = "shrink_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ShrinkAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"rotate_ssl_certs got unknown kwargs: {extra_kwargs!r}") + f"shrink_autonomous_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -34916,8 +39191,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} @@ -34929,7 +39202,6 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -34938,6 +39210,7 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -34948,19 +39221,18 @@ def rotate_ssl_certs(self, autonomous_exadata_infrastructure_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def rotate_vault_key(self, database_id, **kwargs): + def start_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 + Starts 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 @@ -34970,16 +39242,6 @@ def rotate_vault_key(self, 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. @@ -34992,34 +39254,32 @@ def rotate_vault_key(self, database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 start_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}/actions/rotateKey" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/start" method = "POST" - operation_name = "rotate_vault_key" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/RotateVaultKey" + operation_name = "start_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/StartAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"rotate_vault_key got unknown kwargs: {extra_kwargs!r}") + f"start_autonomous_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -35031,9 +39291,7 @@ def rotate_vault_key(self, 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} @@ -35044,7 +39302,6 @@ def rotate_vault_key(self, database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -35053,7 +39310,7 @@ def rotate_vault_key(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35064,25 +39321,37 @@ def rotate_vault_key(self, database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="Database", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def saas_admin_user_status(self, autonomous_database_id, **kwargs): + def start_pluggable_database(self, pluggable_database_id, **kwargs): """ - This operation gets SaaS administrative user status of the Autonomous Database. + Starts a stopped pluggable database. The `openMode` value of the pluggable database will be `READ_WRITE` upon completion. - :param str autonomous_database_id: (required) + :param str pluggable_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_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. @@ -35095,32 +39364,34 @@ def saas_admin_user_status(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SaasAdminUserStatus` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use saas_admin_user_status API. + Click `here `__ to see an example of how to use start_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/getSaasAdminUserStatus" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/start" method = "POST" - operation_name = "saas_admin_user_status" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/SaasAdminUserStatus" + operation_name = "start_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/StartPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "opc_request_id" + "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( - f"saas_admin_user_status got unknown kwargs: {extra_kwargs!r}") + f"start_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -35132,7 +39403,9 @@ def saas_admin_user_status(self, autonomous_database_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-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} @@ -35143,6 +39416,7 @@ def saas_admin_user_status(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -35151,7 +39425,7 @@ def saas_admin_user_status(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="SaasAdminUserStatus", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35162,39 +39436,30 @@ def saas_admin_user_status(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="SaasAdminUserStatus", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def scan_external_container_database_pluggable_databases(self, external_container_database_id, external_database_connector_id, **kwargs): + def stop_autonomous_database(self, autonomous_database_id, **kwargs): """ - Scans for pluggable databases in the specified external container database. - This operation will return un-registered pluggable databases in the :func:`get_work_request` operation. + Stops the specified Autonomous Database. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `OCID`__. + :param str autonomous_database_id: (required) + The 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 - 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. @@ -35207,33 +39472,33 @@ def scan_external_container_database_pluggable_databases(self, external_containe allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 scan_external_container_database_pluggable_databases API. + Click `here `__ to see an example of how to use stop_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId', 'externalDatabaseConnectorId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}/actions/scanPluggableDatabases" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/stop" method = "POST" - operation_name = "scan_external_container_database_pluggable_databases" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/ScanExternalContainerDatabasePluggableDatabases" + operation_name = "stop_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/StopAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"scan_external_container_database_pluggable_databases got unknown kwargs: {extra_kwargs!r}") + f"stop_autonomous_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -35242,16 +39507,11 @@ def scan_external_container_database_pluggable_databases(self, external_containe if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - 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", - "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} @@ -35262,7 +39522,6 @@ def scan_external_container_database_pluggable_databases(self, external_containe if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -35270,8 +39529,8 @@ def scan_external_container_database_pluggable_databases(self, external_containe resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35281,19 +39540,19 @@ def scan_external_container_database_pluggable_databases(self, external_containe resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def shrink_autonomous_database(self, autonomous_database_id, **kwargs): + def stop_pluggable_database(self, pluggable_database_id, **kwargs): """ - This operation shrinks the current allocated storage down to the current actual used data storage (actualUsedDataStorageSizeInTBs). The if the base storage value for the database (dataStorageSizeInTBs) is larger than the actualUsedDataStorageSizeInTBs value, you are billed for the base storage value. + Stops a pluggable database. The `openMode` value of the pluggable database will be `MOUNTED` upon completion. - :param str autonomous_database_id: (required) + :param str pluggable_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -35303,6 +39562,16 @@ def shrink_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 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. @@ -35315,32 +39584,34 @@ def shrink_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use shrink_autonomous_database API. + Click `here `__ to see an example of how to use stop_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/shrink" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/stop" method = "POST" - operation_name = "shrink_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/ShrinkAutonomousDatabase" + operation_name = "stop_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/StopPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match" + "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( - f"shrink_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"stop_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -35352,7 +39623,9 @@ def shrink_autonomous_database(self, autonomous_database_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), + "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} @@ -35363,6 +39636,7 @@ def shrink_autonomous_database(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -35371,7 +39645,7 @@ def shrink_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35382,19 +39656,26 @@ def shrink_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def start_autonomous_database(self, autonomous_database_id, **kwargs): + def switchover_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, **kwargs): """ - Starts the specified Autonomous Database. + 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_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 @@ -35415,18 +39696,18 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousContainerDatabaseDataguardAssociation` :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_autonomous_container_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/start" + required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/switchover" method = "POST" - operation_name = "start_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/StartAutonomousDatabase" + operation_name = "switchover_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/SwitchoverAutonomousContainerDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ @@ -35437,10 +39718,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( - f"start_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"switchover_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_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} @@ -35471,7 +39753,7 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35482,18 +39764,23 @@ def start_autonomous_database(self, autonomous_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousDatabase", + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def start_pluggable_database(self, pluggable_database_id, **kwargs): + def switchover_autonomous_database(self, autonomous_database_id, **kwargs): """ - Starts a stopped pluggable database. The `openMode` value of the pluggable database will be `READ_WRITE` upon completion. + Initiates a switchover of the specified Autonomous Database to the associated peer database. Applicable only to databases with Disaster Recovery enabled. + This API should be called in the remote region where the peer database resides. + Below parameter is optional: + - `peerDbId` + Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. + If this parameter is not provided, the switchover will happen in the same region. - :param str pluggable_database_id: (required) + :param str autonomous_database_id: (required) The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -35503,9 +39790,6 @@ def start_pluggable_database(self, pluggable_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 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 @@ -35513,6 +39797,12 @@ def start_pluggable_database(self, pluggable_database_id, **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 str peer_db_id: (optional) + The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database. + :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. @@ -35525,34 +39815,35 @@ def start_pluggable_database(self, pluggable_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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 start_pluggable_database API. + Click `here `__ to see an example of how to use switchover_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/start" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/switchover" method = "POST" - operation_name = "start_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/StartPluggableDatabase" + operation_name = "switchover_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/SwitchoverAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", "if_match", + "opc_retry_token", "opc_request_id", - "opc_retry_token" + "peer_db_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"start_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"switchover_autonomous_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "autonomousDatabaseId": autonomous_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -35561,12 +39852,17 @@ def start_pluggable_database(self, pluggable_database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') + query_params = { + "peerDbId": kwargs.get("peer_db_id", 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), - "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} @@ -35585,8 +39881,9 @@ def start_pluggable_database(self, pluggable_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="PluggableDatabase", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35596,31 +39893,40 @@ def start_pluggable_database(self, pluggable_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, + query_params=query_params, header_params=header_params, - response_type="PluggableDatabase", + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def stop_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): """ - Stops 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 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. @@ -35633,33 +39939,33 @@ def stop_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 stop_autonomous_database API. + Click `here `__ to see an example of how to use switchover_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/stop" + required_arguments = ['databaseId', 'dataGuardAssociationId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/switchover" method = "POST" - operation_name = "stop_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/StopAutonomousDatabase" + operation_name = "switchover_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/SwitchoverDataGuardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"stop_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"switchover_data_guard_association got unknown kwargs: {extra_kwargs!r}") 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} @@ -35671,8 +39977,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} @@ -35691,7 +39996,8 @@ def stop_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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35702,19 +40008,20 @@ def stop_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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def stop_pluggable_database(self, pluggable_database_id, **kwargs): + def terminate_autonomous_container_database(self, autonomous_container_database_id, **kwargs): """ - Stops a pluggable database. The `openMode` value of the pluggable database will be `MOUNTED` upon completion. + 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 pluggable_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 @@ -35723,16 +40030,6 @@ def stop_pluggable_database(self, pluggable_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 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. @@ -35745,34 +40042,32 @@ def stop_pluggable_database(self, pluggable_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :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_pluggable_database API. + Click `here `__ to see an example of how to use terminate_autonomous_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}/actions/stop" - method = "POST" - operation_name = "stop_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/StopPluggableDatabase" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + method = "DELETE" + operation_name = "terminate_autonomous_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/TerminateAutonomousContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "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( - f"stop_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"terminate_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "autonomousContainerDatabaseId": autonomous_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -35784,9 +40079,7 @@ def stop_pluggable_database(self, pluggable_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), - "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} @@ -35797,7 +40090,6 @@ def stop_pluggable_database(self, pluggable_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -35806,7 +40098,6 @@ def stop_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35817,26 +40108,18 @@ def stop_pluggable_database(self, pluggable_database_id, **kwargs): method=method, path_params=path_params, header_params=header_params, - response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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`__. + **Deprecated.** To terminate an Exadata Infrastructure resource in the Oracle cloud, use the :func:`delete_cloud_exadata_infrastructure` operation. To delete an Autonomous Exadata VM cluster in the Oracle cloud, use the :func:`delete_cloud_autonomous_vm_cluster` 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 autonomous_exadata_infrastructure_id: (required) + The Autonomous Exadata Infrastructure `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -35857,18 +40140,18 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}/actions/switchover" - method = "POST" - operation_name = "switchover_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/SwitchoverAutonomousContainerDatabaseDataguardAssociation" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" + method = "DELETE" + operation_name = "terminate_autonomous_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/TerminateAutonomousExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ @@ -35879,11 +40162,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( - f"switchover_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"terminate_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") 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} @@ -35914,7 +40196,6 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -35925,24 +40206,25 @@ def switchover_autonomous_container_database_dataguard_association(self, autonom method=method, path_params=path_params, header_params=header_params, - response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 peer database. Applicable only to databases with Disaster Recovery enabled. - This API should be called in the remote region where the peer database resides. - Below parameter is optional: - - `peerDbId` - Use this parameter to specify the database OCID of the Disaster Recovery peer, which is located in a different (remote) region from the current peer database. - If this parameter is not provided, the switchover will happen in the same region. + 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm - :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 @@ -35951,19 +40233,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 str peer_db_id: (optional) - The database OCID(/Content/General/Concepts/identifiers.htm) of the Disaster Recovery peer (source Primary) database, which is located in a different (remote) region from the current peer database. - :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. @@ -35976,35 +40245,32 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/switchover" - method = "POST" - operation_name = "switchover_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/SwitchoverAutonomousDatabase" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}" + method = "DELETE" + operation_name = "terminate_db_system" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/TerminateDbSystem" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", - "if_match", - "opc_retry_token", - "opc_request_id", - "peer_db_id" + "if_match" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"switchover_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"terminate_db_system got unknown kwargs: {extra_kwargs!r}") 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} @@ -36013,17 +40279,10 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0): raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string') - query_params = { - "peerDbId": kwargs.get("peer_db_id", 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) + "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} @@ -36034,7 +40293,6 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): if retry_strategy: if not isinstance(retry_strategy, retry.NoneRetryStrategy): - self.base_client.add_opc_retry_token_if_needed(header_params) self.base_client.add_opc_client_retries_header(header_params) retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) return retry_strategy.make_retrying_call( @@ -36042,9 +40300,7 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36054,34 +40310,24 @@ def switchover_autonomous_database(self, autonomous_database_id, **kwargs): resource_path=resource_path, method=method, path_params=path_params, - query_params=query_params, header_params=header_params, - response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - 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 display name, maintenance preference, backup retention, and tags. - __ 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` @@ -36100,18 +40346,18 @@ def switchover_data_guard_association(self, database_id, data_guard_association_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'dataGuardAssociationId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}/actions/switchover" - method = "POST" - operation_name = "switchover_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/SwitchoverDataGuardAssociation" + required_arguments = ['autonomousContainerDatabaseId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + method = "PUT" + operation_name = "update_autonomous_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/UpdateAutonomousContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -36122,11 +40368,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( - f"switchover_data_guard_association got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -36157,8 +40402,8 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36169,16 +40414,16 @@ 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", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def terminate_autonomous_container_database(self, autonomous_container_database_id, **kwargs): + def update_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, update_autonomous_container_database_data_guard_association_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. + Update Autonomous Data Guard association. :param str autonomous_container_database_id: (required) @@ -36186,11 +40431,22 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ __ 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.UpdateAutonomousContainerDatabaseDataGuardAssociationDetails update_autonomous_container_database_data_guard_association_details: (required) + A request to update Data Guard association of a 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. @@ -36203,32 +40459,34 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 terminate_autonomous_container_database API. + Click `here `__ to see an example of how to use update_autonomous_container_database_dataguard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" - method = "DELETE" - operation_name = "terminate_autonomous_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/TerminateAutonomousContainerDatabase" + required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] + resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" + method = "PUT" + operation_name = "update_autonomous_container_database_dataguard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/UpdateAutonomousContainerDatabaseDataguardAssociation" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"terminate_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_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} @@ -36240,7 +40498,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} @@ -36259,6 +40518,8 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_container_database_data_guard_association_details, + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36269,26 +40530,34 @@ def terminate_autonomous_container_database(self, autonomous_container_database_ method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_container_database_data_guard_association_details, + response_type="AutonomousContainerDatabaseDataguardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, **kwargs): + def update_autonomous_database(self, autonomous_database_id, update_autonomous_database_details, **kwargs): """ - **Deprecated.** To terminate an Exadata Infrastructure resource in the Oracle cloud, use the :func:`delete_cloud_exadata_infrastructure` operation. To delete an Autonomous Exadata VM cluster in the Oracle cloud, use the :func:`delete_cloud_autonomous_vm_cluster` operation. + 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_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 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. @@ -36301,32 +40570,33 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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_exadata_infrastructure API. + Click `here `__ to see an example of how to use update_autonomous_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" - method = "DELETE" - operation_name = "terminate_autonomous_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/TerminateAutonomousExadataInfrastructure" + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}" + method = "PUT" + operation_name = "update_autonomous_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/UpdateAutonomousDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"terminate_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_database got unknown kwargs: {extra_kwargs!r}") 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} @@ -36338,7 +40608,8 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast 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} @@ -36357,6 +40628,8 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_database_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36367,33 +40640,34 @@ def terminate_autonomous_exadata_infrastructure(self, autonomous_exadata_infrast method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_database_details, + response_type="AutonomousDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def terminate_db_system(self, db_system_id, **kwargs): + def update_autonomous_database_backup(self, autonomous_database_backup_id, update_autonomous_database_backup_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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Updates the Autonomous Database backup of the specified database based on the request parameters. - :param str db_system_id: (required) - The DB system `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 + :param oci.database.models.UpdateAutonomousDatabaseBackupDetails update_autonomous_database_backup_details: (required) + Request to update an existing Autonomous Database backup. + :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. @@ -36406,32 +40680,33 @@ def terminate_db_system(self, db_system_id, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseBackup` :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_backup API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}" - method = "DELETE" - operation_name = "terminate_db_system" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/TerminateDbSystem" + required_arguments = ['autonomousDatabaseBackupId'] + resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" + method = "PUT" + operation_name = "update_autonomous_database_backup" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/UpdateAutonomousDatabaseBackup" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"terminate_db_system got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id + "autonomousDatabaseBackupId": autonomous_database_backup_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -36443,7 +40718,8 @@ 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) + "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} @@ -36462,6 +40738,8 @@ def terminate_db_system(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36472,28 +40750,23 @@ def terminate_db_system(self, db_system_id, **kwargs): method=method, path_params=path_params, header_params=header_params, + body=update_autonomous_database_backup_details, + response_type="AutonomousDatabaseBackup", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_container_database(self, autonomous_container_database_id, update_autonomous_container_database_details, **kwargs): + def update_autonomous_database_regional_wallet(self, update_autonomous_database_wallet_details, **kwargs): """ - Updates the properties of an Autonomous Container Database, such as display name, maintenance preference, backup retention, and tags. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + Updates the Autonomous Database regional wallet. - __ 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.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. @@ -36507,44 +40780,34 @@ def update_autonomous_container_database(self, autonomous_container_database_id, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 update_autonomous_container_database API. + Click `here `__ to see an example of how to use update_autonomous_database_regional_wallet API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}" + required_arguments = [] + resource_path = "/autonomousDatabases/wallet" method = "PUT" - operation_name = "update_autonomous_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabase/UpdateAutonomousContainerDatabase" + operation_name = "update_autonomous_database_regional_wallet" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/UpdateAutonomousDatabaseRegionalWallet" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_container_database got unknown kwargs: {extra_kwargs!r}") - - 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(f'Parameter {k} cannot be None, whitespace or empty string') + f"update_autonomous_database_regional_wallet got unknown kwargs: {extra_kwargs!r}") 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} @@ -36561,10 +40824,8 @@ def update_autonomous_container_database(self, autonomous_container_database_id, 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_database_wallet_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36573,32 +40834,25 @@ def update_autonomous_container_database(self, autonomous_container_database_id, 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_database_wallet_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_container_database_dataguard_association(self, autonomous_container_database_id, autonomous_container_database_dataguard_association_id, update_autonomous_container_database_data_guard_association_details, **kwargs): + def update_autonomous_database_software_image(self, autonomous_database_software_image_id, update_autonomous_database_software_image_details, **kwargs): """ - Update Autonomous Data Guard association. - - - :param str autonomous_container_database_id: (required) - The Autonomous Container Database `OCID`__. + Updates the properties of an Autonomous Database Software Image, like add tags - __ 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_database_software_image_id: (required) + The Autonomous Database Software Image `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateAutonomousContainerDatabaseDataGuardAssociationDetails update_autonomous_container_database_data_guard_association_details: (required) - A request to update Data Guard association of a database. + :param oci.database.models.UpdateAutonomousDatabaseSoftwareImageDetails update_autonomous_database_software_image_details: (required) + Request to update the properties of an Autonomous Database Software Image. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -36620,18 +40874,18 @@ def update_autonomous_container_database_dataguard_association(self, autonomous_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousDatabaseSoftwareImage` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_container_database_dataguard_association API. + Click `here `__ to see an example of how to use update_autonomous_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousContainerDatabaseId', 'autonomousContainerDatabaseDataguardAssociationId'] - resource_path = "/autonomousContainerDatabases/{autonomousContainerDatabaseId}/autonomousContainerDatabaseDataguardAssociations/{autonomousContainerDatabaseDataguardAssociationId}" + required_arguments = ['autonomousDatabaseSoftwareImageId'] + resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" method = "PUT" - operation_name = "update_autonomous_container_database_dataguard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousContainerDatabaseDataguardAssociation/UpdateAutonomousContainerDatabaseDataguardAssociation" + operation_name = "update_autonomous_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/UpdateAutonomousDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ @@ -36643,11 +40897,10 @@ def update_autonomous_container_database_dataguard_association(self, autonomous_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_autonomous_container_database_dataguard_association got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousContainerDatabaseId": autonomous_container_database_id, - "autonomousContainerDatabaseDataguardAssociationId": autonomous_container_database_dataguard_association_id + "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -36679,8 +40932,8 @@ def update_autonomous_container_database_dataguard_association(self, autonomous_ method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_container_database_data_guard_association_details, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=update_autonomous_database_software_image_details, + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36691,16 +40944,16 @@ def update_autonomous_container_database_dataguard_association(self, autonomous_ method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_container_database_data_guard_association_details, - response_type="AutonomousContainerDatabaseDataguardAssociation", + body=update_autonomous_database_software_image_details, + response_type="AutonomousDatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_database(self, autonomous_database_id, update_autonomous_database_details, **kwargs): + def update_autonomous_database_wallet(self, autonomous_database_id, update_autonomous_database_wallet_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 wallet for the specified Autonomous Database. :param str autonomous_database_id: (required) @@ -36708,13 +40961,8 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_d __ 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 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. @@ -36731,30 +40979,29 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_d allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 update_autonomous_database API. + Click `here `__ to see an example of how to use update_autonomous_database_wallet API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}" + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" method = "PUT" - operation_name = "update_autonomous_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabase/UpdateAutonomousDatabase" + operation_name = "update_autonomous_database_wallet" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/UpdateAutonomousDatabaseWallet" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_database got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") path_params = { "autonomousDatabaseId": autonomous_database_id @@ -36769,7 +41016,6 @@ def update_autonomous_database(self, autonomous_database_id, update_autonomous_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) } header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None} @@ -36789,8 +41035,7 @@ 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_database_wallet_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36801,34 +41046,30 @@ 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_database_wallet_details, allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_database_backup(self, autonomous_database_backup_id, update_autonomous_database_backup_details, **kwargs): + def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **kwargs): """ - Updates the Autonomous Database backup of the specified database based on the request parameters. + **Deprecated.** Use the :func:`update_cloud_exadata_infrastructure` operation to update an Exadata Infrastructure resource and :func:`update_cloud_autonomous_vm_cluster` operation to update an Autonomous Exadata VM cluster. - :param str autonomous_database_backup_id: (required) - The `OCID`__ of the Autonomous Database backup. + :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.UpdateAutonomousDatabaseBackupDetails update_autonomous_database_backup_details: (required) - Request to update an existing Autonomous Database backup. + :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` 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. @@ -36841,33 +41082,32 @@ def update_autonomous_database_backup(self, autonomous_database_backup_id, updat allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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 :class:`~oci.database.models.AutonomousExadataInfrastructure` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_autonomous_database_backup API. + Click `here `__ to see an example of how to use update_autonomous_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseBackupId'] - resource_path = "/autonomousDatabaseBackups/{autonomousDatabaseBackupId}" + required_arguments = ['autonomousExadataInfrastructureId'] + resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" method = "PUT" - operation_name = "update_autonomous_database_backup" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseBackup/UpdateAutonomousDatabaseBackup" + operation_name = "update_autonomous_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/UpdateAutonomousExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_database_backup got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseBackupId": autonomous_database_backup_id + "autonomousExadataInfrastructureId": autonomous_exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -36879,8 +41119,7 @@ def update_autonomous_database_backup(self, autonomous_database_backup_id, updat 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} @@ -36899,8 +41138,8 @@ def update_autonomous_database_backup(self, autonomous_database_backup_id, updat method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup", + body=update_autonomous_exadata_infrastructures_details, + response_type="AutonomousExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36911,20 +41150,30 @@ def update_autonomous_database_backup(self, autonomous_database_backup_id, updat method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_backup_details, - response_type="AutonomousDatabaseBackup", + body=update_autonomous_exadata_infrastructures_details, + response_type="AutonomousExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_database_regional_wallet(self, update_autonomous_database_wallet_details, **kwargs): + def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **kwargs): """ - Updates the Autonomous Database regional wallet. + Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system.To update an Autonomous VM Cluster in the Oracle cloud, see :func:`update_cloud_autonomous_vm_cluster`. - :param oci.database.models.UpdateAutonomousDatabaseWalletDetails update_autonomous_database_wallet_details: (required) - Request to update the properties of Autonomous Database regional wallet. + :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 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. @@ -36941,33 +41190,45 @@ def update_autonomous_database_regional_wallet(self, update_autonomous_database_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.AutonomousVmCluster` :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_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = [] - resource_path = "/autonomousDatabases/wallet" + required_arguments = ['autonomousVmClusterId'] + resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" method = "PUT" - operation_name = "update_autonomous_database_regional_wallet" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/UpdateAutonomousDatabaseRegionalWallet" + operation_name = "update_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/UpdateAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_database_regional_wallet got unknown kwargs: {extra_kwargs!r}") + f"update_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') 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} @@ -36985,8 +41246,10 @@ 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_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -36995,25 +41258,30 @@ def update_autonomous_database_regional_wallet(self, update_autonomous_database_ 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_autonomous_vm_cluster_details, + response_type="AutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_database_software_image(self, autonomous_database_software_image_id, update_autonomous_database_software_image_details, **kwargs): + def update_backup_destination(self, backup_destination_id, update_backup_destination_details, **kwargs): """ - Updates the properties of an Autonomous Database Software Image, like add tags + 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 autonomous_database_software_image_id: (required) - The Autonomous Database Software Image `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.UpdateAutonomousDatabaseSoftwareImageDetails update_autonomous_database_software_image_details: (required) - Request to update the properties of an Autonomous Database Software Image. + :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` @@ -37035,18 +41303,18 @@ def update_autonomous_database_software_image(self, autonomous_database_software allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.AutonomousDatabaseSoftwareImage` + :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_software_image API. + Click `here `__ to see an example of how to use update_backup_destination API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseSoftwareImageId'] - resource_path = "/autonomousDatabaseSoftwareImages/{autonomousDatabaseSoftwareImageId}" + required_arguments = ['backupDestinationId'] + resource_path = "/backupDestinations/{backupDestinationId}" method = "PUT" - operation_name = "update_autonomous_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseSoftwareImage/UpdateAutonomousDatabaseSoftwareImage" + operation_name = "update_backup_destination" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/UpdateBackupDestination" # Don't accept unknown kwargs expected_kwargs = [ @@ -37058,10 +41326,10 @@ def update_autonomous_database_software_image(self, autonomous_database_software extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_autonomous_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"update_backup_destination got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseSoftwareImageId": autonomous_database_software_image_id + "backupDestinationId": backup_destination_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -37093,8 +41361,8 @@ def update_autonomous_database_software_image(self, autonomous_database_software method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_software_image_details, - response_type="AutonomousDatabaseSoftwareImage", + body=update_backup_destination_details, + response_type="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37105,25 +41373,30 @@ def update_autonomous_database_software_image(self, autonomous_database_software method=method, path_params=path_params, header_params=header_params, - body=update_autonomous_database_software_image_details, - response_type="AutonomousDatabaseSoftwareImage", + body=update_backup_destination_details, + response_type="BackupDestination", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_database_wallet(self, autonomous_database_id, update_autonomous_database_wallet_details, **kwargs): + def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, update_cloud_autonomous_vm_cluster_details, **kwargs): """ - Updates the wallet for the specified Autonomous Database. + Updates the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`update_autonomous_vm_cluster`. - :param str autonomous_database_id: (required) - The database `OCID`__. + :param str cloud_autonomous_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.UpdateCloudAutonomousVmClusterDetails update_cloud_autonomous_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. @@ -37140,32 +41413,33 @@ def update_autonomous_database_wallet(self, autonomous_database_id, update_auton allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudAutonomousVmCluster` :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_autonomous_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousDatabaseId'] - resource_path = "/autonomousDatabases/{autonomousDatabaseId}/wallet" + required_arguments = ['cloudAutonomousVmClusterId'] + resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" method = "PUT" - operation_name = "update_autonomous_database_wallet" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousDatabaseWallet/UpdateAutonomousDatabaseWallet" + operation_name = "update_cloud_autonomous_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/UpdateCloudAutonomousVmCluster" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_database_wallet got unknown kwargs: {extra_kwargs!r}") + f"update_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "autonomousDatabaseId": autonomous_database_id + "cloudAutonomousVmClusterId": cloud_autonomous_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -37177,6 +41451,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} @@ -37196,7 +41471,8 @@ 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_autonomous_vm_cluster_details, + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37207,30 +41483,34 @@ 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_autonomous_vm_cluster_details, + response_type="CloudAutonomousVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastructure_id, update_autonomous_exadata_infrastructures_details, **kwargs): + def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **kwargs): """ - **Deprecated.** Use the :func:`update_cloud_exadata_infrastructure` operation to update an Exadata Infrastructure resource and :func:`update_cloud_autonomous_vm_cluster` operation to update an Autonomous Exadata VM cluster. + Updates the Cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure 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 - :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.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. + :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. @@ -37243,32 +41523,33 @@ def update_autonomous_exadata_infrastructure(self, autonomous_exadata_infrastruc allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudExadataInfrastructure` :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_exadata_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousExadataInfrastructureId'] - resource_path = "/autonomousExadataInfrastructures/{autonomousExadataInfrastructureId}" + required_arguments = ['cloudExadataInfrastructureId'] + resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" method = "PUT" - operation_name = "update_autonomous_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousExadataInfrastructure/UpdateAutonomousExadataInfrastructure" + operation_name = "update_cloud_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/UpdateCloudExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_autonomous_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"update_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") 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} @@ -37280,7 +41561,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} @@ -37299,8 +41581,8 @@ 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_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37311,25 +41593,25 @@ 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_exadata_infrastructure_details, + response_type="CloudExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomous_vm_cluster_details, **kwargs): + def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, **kwargs): """ - Updates the specified Autonomous VM cluster for the Exadata Cloud@Customer system.To update an Autonomous VM Cluster in the Oracle cloud, see :func:`update_cloud_autonomous_vm_cluster`. + Updates the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. - :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.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` @@ -37351,18 +41633,18 @@ def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomo allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.CloudVmCluster` :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 API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['autonomousVmClusterId'] - resource_path = "/autonomousVmClusters/{autonomousVmClusterId}" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}" method = "PUT" - operation_name = "update_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/AutonomousVmCluster/UpdateAutonomousVmCluster" + operation_name = "update_cloud_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/UpdateCloudVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -37374,10 +41656,10 @@ def update_autonomous_vm_cluster(self, autonomous_vm_cluster_id, update_autonomo extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"update_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") 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} @@ -37409,8 +41691,8 @@ 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=update_cloud_vm_cluster_details, + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37421,37 +41703,34 @@ 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=update_cloud_vm_cluster_details, + response_type="CloudVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_backup_destination(self, backup_destination_id, update_backup_destination_details, **kwargs): + def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_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. + Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance. - :param str backup_destination_id: (required) - The `OCID`__ of the backup destination. + :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.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.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. @@ -37464,33 +41743,33 @@ def update_backup_destination(self, backup_destination_id, update_backup_destina allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataIormConfig` :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_cloud_vm_cluster_iorm_config API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['backupDestinationId'] - resource_path = "/backupDestinations/{backupDestinationId}" + required_arguments = ['cloudVmClusterId'] + resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" method = "PUT" - operation_name = "update_backup_destination" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/BackupDestination/UpdateBackupDestination" + operation_name = "update_cloud_vm_cluster_iorm_config" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/UpdateCloudVmClusterIormConfig" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_backup_destination got unknown kwargs: {extra_kwargs!r}") + f"update_cloud_vm_cluster_iorm_config got unknown kwargs: {extra_kwargs!r}") path_params = { - "backupDestinationId": backup_destination_id + "cloudVmClusterId": cloud_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -37502,8 +41781,8 @@ 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) + "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} @@ -37522,8 +41801,8 @@ 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=cloud_vm_cluster_iorm_config_update_details, + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37534,25 +41813,28 @@ 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=cloud_vm_cluster_iorm_config_update_details, + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, update_cloud_autonomous_vm_cluster_details, **kwargs): + def update_console_connection(self, db_node_id, console_connection_id, update_console_connection_details, **kwargs): """ - Updates the specified Autonomous Exadata VM cluster in the Oracle cloud. For Exadata Cloud@Customer systems, see :func:`update_autonomous_vm_cluster`. + Updates the specified database node console connection. - :param str cloud_autonomous_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 oci.database.models.UpdateCloudAutonomousVmClusterDetails update_cloud_autonomous_vm_cluster_details: (required) - Request to update the attributes of a cloud VM cluster. + :param str console_connection_id: (required) + The OCID of the console connection. + + :param oci.database.models.UpdateConsoleConnectionDetails update_console_connection_details: (required) + Request to update the specified database node console connection. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -37574,18 +41856,18 @@ def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, upd allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.CloudAutonomousVmCluster` + :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 update_cloud_autonomous_vm_cluster API. + Click `here `__ to see an example of how to use update_console_connection API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudAutonomousVmClusterId'] - resource_path = "/cloudAutonomousVmClusters/{cloudAutonomousVmClusterId}" + required_arguments = ['dbNodeId', 'consoleConnectionId'] + resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" method = "PUT" - operation_name = "update_cloud_autonomous_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudAutonomousVmCluster/UpdateCloudAutonomousVmCluster" + operation_name = "update_console_connection" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/UpdateConsoleConnection" # Don't accept unknown kwargs expected_kwargs = [ @@ -37597,10 +41879,11 @@ def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, upd extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_cloud_autonomous_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"update_console_connection got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudAutonomousVmClusterId": cloud_autonomous_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} @@ -37632,8 +41915,8 @@ def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_cloud_autonomous_vm_cluster_details, - response_type="CloudAutonomousVmCluster", + body=update_console_connection_details, + response_type="ConsoleConnection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37644,25 +41927,28 @@ def update_cloud_autonomous_vm_cluster(self, cloud_autonomous_vm_cluster_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_cloud_autonomous_vm_cluster_details, - response_type="CloudAutonomousVmCluster", + body=update_console_connection_details, + response_type="ConsoleConnection", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, update_cloud_exadata_infrastructure_details, **kwargs): + def update_console_history(self, db_node_id, console_history_id, update_console_history_details, **kwargs): """ - Updates the Cloud Exadata infrastructure resource. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Updates the specified database node console history. - :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 oci.database.models.UpdateCloudExadataInfrastructureDetails update_cloud_exadata_infrastructure_details: (required) - Request to update the properties of an cloud Exadata infrastructure resource. + :param str console_history_id: (required) + The OCID of the console history. + + :param oci.database.models.UpdateConsoleHistoryDetails update_console_history_details: (required) + Request to update the specified database node console history. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -37684,18 +41970,18 @@ def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, u allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ConsoleHistory` :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_console_history API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudExadataInfrastructureId'] - resource_path = "/cloudExadataInfrastructures/{cloudExadataInfrastructureId}" + required_arguments = ['dbNodeId', 'consoleHistoryId'] + resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" method = "PUT" - operation_name = "update_cloud_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudExadataInfrastructure/UpdateCloudExadataInfrastructure" + operation_name = "update_console_history" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/UpdateConsoleHistory" # Don't accept unknown kwargs expected_kwargs = [ @@ -37707,10 +41993,11 @@ def update_cloud_exadata_infrastructure(self, cloud_exadata_infrastructure_id, u extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_cloud_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"update_console_history got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudExadataInfrastructureId": cloud_exadata_infrastructure_id + "dbNodeId": db_node_id, + "consoleHistoryId": console_history_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -37742,8 +42029,8 @@ 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_console_history_details, + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37754,25 +42041,30 @@ 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_console_history_details, + response_type="ConsoleHistory", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_details, **kwargs): + def update_data_guard_association(self, database_id, data_guard_association_id, update_data_guard_association_details, **kwargs): """ - Updates the specified cloud VM cluster. Applies to Exadata Cloud Service instances and Autonomous Database on dedicated Exadata infrastructure only. + Updates the Data Guard association the specified database. This API can be used to change the `protectionMode` and `transportType` of the Data Guard association. - :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 oci.database.models.UpdateCloudVmClusterDetails update_cloud_vm_cluster_details: (required) - Request to update the attributes of a cloud VM cluster. + :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.UpdateDataGuardAssociationDetails update_data_guard_association_details: (required) + A request to update Data Guard association of a database. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -37794,18 +42086,18 @@ def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_d allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DataGuardAssociation` :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_data_guard_association API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}" + required_arguments = ['databaseId', 'dataGuardAssociationId'] + resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" method = "PUT" - operation_name = "update_cloud_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/UpdateCloudVmCluster" + operation_name = "update_data_guard_association" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/UpdateDataGuardAssociation" # Don't accept unknown kwargs expected_kwargs = [ @@ -37817,10 +42109,11 @@ def update_cloud_vm_cluster(self, cloud_vm_cluster_id, update_cloud_vm_cluster_d extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_cloud_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"update_data_guard_association got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_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} @@ -37852,8 +42145,8 @@ 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_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37864,29 +42157,26 @@ 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_data_guard_association_details, + response_type="DataGuardAssociation", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_cluster_iorm_config_update_details, **kwargs): + def update_database(self, database_id, update_database_details, **kwargs): """ - Updates the IORM settings for the specified cloud VM cluster in an Exadata Cloud Service instance. + Update the specified database based on the request parameters provided. - :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 oci.database.models.ExadataIormConfigUpdateDetails cloud_vm_cluster_iorm_config_update_details: (required) + :param oci.database.models.UpdateDatabaseDetails update_database_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 @@ -37904,33 +42194,32 @@ def update_cloud_vm_cluster_iorm_config(self, cloud_vm_cluster_id, cloud_vm_clus allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.Database` :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_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['cloudVmClusterId'] - resource_path = "/cloudVmClusters/{cloudVmClusterId}/CloudVmClusterIormConfig" + required_arguments = ['databaseId'] + resource_path = "/databases/{databaseId}" method = "PUT" - operation_name = "update_cloud_vm_cluster_iorm_config" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/CloudVmCluster/UpdateCloudVmClusterIormConfig" + operation_name = "update_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/UpdateDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_cloud_vm_cluster_iorm_config got unknown kwargs: {extra_kwargs!r}") + f"update_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "cloudVmClusterId": cloud_vm_cluster_id + "databaseId": database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -37942,7 +42231,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} @@ -37962,8 +42250,8 @@ 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_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -37974,37 +42262,31 @@ 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_database_details, + response_type="Database", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_console_connection(self, db_node_id, console_connection_id, update_console_connection_details, **kwargs): + def update_database_software_image(self, database_software_image_id, update_database_software_image_details, **kwargs): """ - Updates the specified database node console connection. + Updates the properties of a Database Software Image, like Display Nmae - :param str db_node_id: (required) - The database node `OCID`__. + :param str database_software_image_id: (required) + The DB system `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.UpdateConsoleConnectionDetails update_console_connection_details: (required) - Request to update the specified database node console connection. + :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. @@ -38017,34 +42299,32 @@ def update_console_connection(self, db_node_id, console_connection_id, update_co allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DatabaseSoftwareImage` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_console_connection API. + Click `here `__ to see an example of how to use update_database_software_image API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleConnectionId'] - resource_path = "/dbNodes/{dbNodeId}/consoleConnections/{consoleConnectionId}" + required_arguments = ['databaseSoftwareImageId'] + resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" method = "PUT" - operation_name = "update_console_connection" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleConnection/UpdateConsoleConnection" + operation_name = "update_database_software_image" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/UpdateDatabaseSoftwareImage" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_console_connection got unknown kwargs: {extra_kwargs!r}") + f"update_database_software_image got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleConnectionId": console_connection_id + "databaseSoftwareImageId": database_software_image_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38056,8 +42336,7 @@ def update_console_connection(self, db_node_id, console_connection_id, update_co 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} @@ -38076,8 +42355,8 @@ def update_console_connection(self, db_node_id, console_connection_id, update_co method=method, path_params=path_params, header_params=header_params, - body=update_console_connection_details, - response_type="ConsoleConnection", + body=update_database_software_image_details, + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38088,37 +42367,31 @@ def update_console_connection(self, db_node_id, console_connection_id, update_co method=method, path_params=path_params, header_params=header_params, - body=update_console_connection_details, - response_type="ConsoleConnection", + body=update_database_software_image_details, + response_type="DatabaseSoftwareImage", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_console_history(self, db_node_id, console_history_id, update_console_history_details, **kwargs): + def update_db_home(self, db_home_id, update_db_home_details, **kwargs): """ - Updates the specified database node console history. + Patches the specified Database Home. - :param str db_node_id: (required) - The database node `OCID`__. + :param str db_home_id: (required) + The Database Home `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param str console_history_id: (required) - The OCID of the console history. - - :param oci.database.models.UpdateConsoleHistoryDetails update_console_history_details: (required) - Request to update the specified database node console history. + :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. @@ -38131,34 +42404,32 @@ def update_console_history(self, db_node_id, console_history_id, update_console_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ConsoleHistory` + :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_console_history API. + Click `here `__ to see an example of how to use update_db_home API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId', 'consoleHistoryId'] - resource_path = "/dbNodes/{dbNodeId}/consoleHistories/{consoleHistoryId}" + required_arguments = ['dbHomeId'] + resource_path = "/dbHomes/{dbHomeId}" method = "PUT" - operation_name = "update_console_history" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ConsoleHistory/UpdateConsoleHistory" + operation_name = "update_db_home" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/UpdateDbHome" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_console_history got unknown kwargs: {extra_kwargs!r}") + f"update_db_home got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id, - "consoleHistoryId": console_history_id + "dbHomeId": db_home_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38170,8 +42441,7 @@ def update_console_history(self, db_node_id, console_history_id, update_console_ 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} @@ -38190,8 +42460,8 @@ def update_console_history(self, db_node_id, console_history_id, update_console_ method=method, path_params=path_params, header_params=header_params, - body=update_console_history_details, - response_type="ConsoleHistory", + body=update_db_home_details, + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38202,30 +42472,25 @@ def update_console_history(self, db_node_id, console_history_id, update_console_ method=method, path_params=path_params, header_params=header_params, - body=update_console_history_details, - response_type="ConsoleHistory", + body=update_db_home_details, + response_type="DbHome", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_data_guard_association(self, database_id, data_guard_association_id, update_data_guard_association_details, **kwargs): + def update_db_node(self, db_node_id, update_db_node_details, **kwargs): """ - Updates the Data Guard association the specified database. This API can be used to change the `protectionMode` and `transportType` of the Data Guard association. - - - :param str database_id: (required) - The database `OCID`__. + Updates the specified database node. - __ 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 db_node_id: (required) + The database node `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDataGuardAssociationDetails update_data_guard_association_details: (required) - A request to update Data Guard association of a database. + :param oci.database.models.UpdateDbNodeDetails update_db_node_details: (required) + Request to update the specified database node. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -38247,18 +42512,18 @@ def update_data_guard_association(self, database_id, data_guard_association_id, allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbNode` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_data_guard_association API. + Click `here `__ to see an example of how to use update_db_node API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId', 'dataGuardAssociationId'] - resource_path = "/databases/{databaseId}/dataGuardAssociations/{dataGuardAssociationId}" + required_arguments = ['dbNodeId'] + resource_path = "/dbNodes/{dbNodeId}" method = "PUT" - operation_name = "update_data_guard_association" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DataGuardAssociation/UpdateDataGuardAssociation" + operation_name = "update_db_node" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/UpdateDbNode" # Don't accept unknown kwargs expected_kwargs = [ @@ -38270,11 +42535,10 @@ def update_data_guard_association(self, database_id, data_guard_association_id, extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_data_guard_association got unknown kwargs: {extra_kwargs!r}") + f"update_db_node got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseId": database_id, - "dataGuardAssociationId": data_guard_association_id + "dbNodeId": db_node_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38306,8 +42570,8 @@ def update_data_guard_association(self, database_id, data_guard_association_id, method=method, path_params=path_params, header_params=header_params, - body=update_data_guard_association_details, - response_type="DataGuardAssociation", + body=update_db_node_details, + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38318,25 +42582,32 @@ def update_data_guard_association(self, database_id, data_guard_association_id, method=method, path_params=path_params, header_params=header_params, - body=update_data_guard_association_details, - response_type="DataGuardAssociation", + body=update_db_node_details, + response_type="DbNode", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_database(self, database_id, update_database_details, **kwargs): + def update_db_system(self, db_system_id, update_db_system_details, **kwargs): """ - Update the specified database based on the request parameters provided. + Updates the properties of the specified DB system. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - :param str 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/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/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.UpdateDatabaseDetails update_database_details: (required) - Request to perform database update. + :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` @@ -38355,18 +42626,18 @@ def update_database(self, database_id, update_database_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.DbSystem` :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_db_system API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseId'] - resource_path = "/databases/{databaseId}" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}" method = "PUT" - operation_name = "update_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/Database/UpdateDatabase" + operation_name = "update_db_system" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/UpdateDbSystem" # Don't accept unknown kwargs expected_kwargs = [ @@ -38377,10 +42648,10 @@ def update_database(self, database_id, update_database_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_database got unknown kwargs: {extra_kwargs!r}") + f"update_db_system got unknown kwargs: {extra_kwargs!r}") 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} @@ -38411,8 +42682,8 @@ 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_db_system_details, + response_type="DbSystem", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38423,31 +42694,35 @@ 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_db_system_details, + response_type="DbSystem", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_database_software_image(self, database_software_image_id, update_database_software_image_details, **kwargs): + def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadata_infrastructure_details, **kwargs): """ - Updates the properties of a Database Software Image, like Display Nmae + 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_software_image_id: (required) - The DB system `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.UpdateDatabaseSoftwareImageDetails update_database_software_image_details: (required) - Request to update the properties of a DB system. + :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. @@ -38460,32 +42735,33 @@ def update_database_software_image(self, database_software_image_id, update_data allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataInfrastructure` :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_infrastructure API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['databaseSoftwareImageId'] - resource_path = "/databaseSoftwareImages/{databaseSoftwareImageId}" + required_arguments = ['exadataInfrastructureId'] + resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" method = "PUT" - operation_name = "update_database_software_image" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DatabaseSoftwareImage/UpdateDatabaseSoftwareImage" + operation_name = "update_exadata_infrastructure" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/UpdateExadataInfrastructure" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_database_software_image got unknown kwargs: {extra_kwargs!r}") + f"update_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") path_params = { - "databaseSoftwareImageId": database_software_image_id + "exadataInfrastructureId": exadata_infrastructure_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38497,7 +42773,8 @@ def update_database_software_image(self, database_software_image_id, update_data 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} @@ -38516,8 +42793,8 @@ 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=update_exadata_infrastructure_details, + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38528,25 +42805,38 @@ 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=update_exadata_infrastructure_details, + response_type="ExadataInfrastructure", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_db_home(self, db_home_id, update_db_home_details, **kwargs): + def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_details, **kwargs): """ - Patches the specified Database Home. + Updates IORM settings for the specified Exadata DB system. + **Note:** Deprecated for Exadata Cloud Service systems. Use the `new resource model APIs`__ instead. - :param str db_home_id: (required) - The Database Home `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. + + The :func:`update_cloud_vm_cluster_iorm_config` API is used for Exadata systems using the + new resource model. + + __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model + __ https://docs.cloud.oracle.com/iaas/Content/Database/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.UpdateDbHomeDetails update_db_home_details: (required) - Request to update the properties of a Database Home. + :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` @@ -38565,32 +42855,33 @@ def update_db_home(self, db_home_id, update_db_home_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadataIormConfig` :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_exadata_iorm_config API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbHomeId'] - resource_path = "/dbHomes/{dbHomeId}" + required_arguments = ['dbSystemId'] + resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" method = "PUT" - operation_name = "update_db_home" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbHome/UpdateDbHome" + operation_name = "update_exadata_iorm_config" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/UpdateExadataIormConfig" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_db_home got unknown kwargs: {extra_kwargs!r}") + f"update_exadata_iorm_config got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbHomeId": db_home_id + "dbSystemId": db_system_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38602,6 +42893,7 @@ def update_db_home(self, db_home_id, update_db_home_details, **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} @@ -38621,8 +42913,8 @@ 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=exadata_iorm_config_update_details, + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38633,25 +42925,25 @@ 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=exadata_iorm_config_update_details, + response_type="ExadataIormConfig", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_db_node(self, db_node_id, update_db_node_details, **kwargs): + def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, **kwargs): """ - Updates the specified database node. + Updates the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. - :param str db_node_id: (required) - The database node `OCID`__. + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateDbNodeDetails update_db_node_details: (required) - Request to update the specified database node. + :param oci.database.models.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) + Request to update the attributes of a Exadata VM cluster on Exascale Infrastructure. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -38673,18 +42965,18 @@ def update_db_node(self, db_node_id, update_db_node_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExadbVmCluster` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_db_node API. + Click `here `__ to see an example of how to use update_exadb_vm_cluster API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbNodeId'] - resource_path = "/dbNodes/{dbNodeId}" + required_arguments = ['exadbVmClusterId'] + resource_path = "/exadbVmClusters/{exadbVmClusterId}" method = "PUT" - operation_name = "update_db_node" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbNode/UpdateDbNode" + operation_name = "update_exadb_vm_cluster" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/UpdateExadbVmCluster" # Don't accept unknown kwargs expected_kwargs = [ @@ -38696,10 +42988,10 @@ def update_db_node(self, db_node_id, update_db_node_details, **kwargs): extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_db_node got unknown kwargs: {extra_kwargs!r}") + f"update_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbNodeId": db_node_id + "exadbVmClusterId": exadb_vm_cluster_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38731,8 +43023,8 @@ def update_db_node(self, db_node_id, update_db_node_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_db_node_details, - response_type="DbNode", + body=update_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38743,38 +43035,34 @@ def update_db_node(self, db_node_id, update_db_node_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_db_node_details, - response_type="DbNode", + body=update_exadb_vm_cluster_details, + response_type="ExadbVmCluster", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_db_system(self, db_system_id, update_db_system_details, **kwargs): + def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_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. - - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + Updates the specified Exadata Database Storage Vault. - :param str db_system_id: (required) - The DB system `OCID`__. + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `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 oci.database.models.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) + Request to update the attributes of a Exadata Database Storage Vault. :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. @@ -38787,32 +43075,33 @@ def update_db_system(self, db_system_id, update_db_system_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExascaleDbStorageVault` :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_exascale_db_storage_vault API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}" + required_arguments = ['exascaleDbStorageVaultId'] + resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" method = "PUT" - operation_name = "update_db_system" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/UpdateDbSystem" + operation_name = "update_exascale_db_storage_vault" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/UpdateExascaleDbStorageVault" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_db_system got unknown kwargs: {extra_kwargs!r}") + f"update_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id + "exascaleDbStorageVaultId": exascale_db_storage_vault_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38824,7 +43113,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} @@ -38843,8 +43133,8 @@ 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_exascale_db_storage_vault_details, + response_type="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38855,26 +43145,25 @@ 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_exascale_db_storage_vault_details, + response_type="ExascaleDbStorageVault", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadata_infrastructure_details, **kwargs): + def update_execution_action(self, execution_action_id, update_execution_action_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 execution action resource. - :param str exadata_infrastructure_id: (required) - The Exadata infrastructure `OCID`__. + :param str execution_action_id: (required) + The execution action `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.UpdateExecutionActionDetails update_execution_action_details: (required) + Request to update the properties of a execution action. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -38896,18 +43185,18 @@ def update_exadata_infrastructure(self, exadata_infrastructure_id, update_exadat allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExecutionAction` :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_execution_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadataInfrastructureId'] - resource_path = "/exadataInfrastructures/{exadataInfrastructureId}" + required_arguments = ['executionActionId'] + resource_path = "/executionActions/{executionActionId}" method = "PUT" - operation_name = "update_exadata_infrastructure" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadataInfrastructure/UpdateExadataInfrastructure" + operation_name = "update_execution_action" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionAction/UpdateExecutionAction" # Don't accept unknown kwargs expected_kwargs = [ @@ -38919,10 +43208,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( - f"update_exadata_infrastructure got unknown kwargs: {extra_kwargs!r}") + f"update_execution_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadataInfrastructureId": exadata_infrastructure_id + "executionActionId": execution_action_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -38954,8 +43243,8 @@ 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_execution_action_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -38966,44 +43255,147 @@ 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_execution_action_details, + response_type="ExecutionAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_details, **kwargs): + def update_execution_window(self, execution_window_id, update_execution_window_details, **kwargs): """ - Updates IORM settings for the specified Exadata DB system. + Updates the execution window resource. - **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 execution_window_id: (required) + The execution window `OCID`__. - The :func:`update_cloud_vm_cluster_iorm_config` API is used for Exadata systems using the - new resource model. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem.htm#exaflexsystem_topic-resource_model - __ https://docs.cloud.oracle.com/iaas/Content/Database/Concepts/exaflexsystem_topic-resource_model_conversion.htm + :param oci.database.models.UpdateExecutionWindowDetails update_execution_window_details: (required) + Request to update the properties of a execution window. + :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 db_system_id: (required) - The DB system `OCID`__. + :param str opc_request_id: (optional) + Unique identifier for the request. - __ 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 oci.database.models.ExadataIormConfigUpdateDetails exadata_iorm_config_update_details: (required) - Request to perform database update. + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + The specifics of the default retry strategy are described `here `__. - :param str opc_request_id: (optional) - Unique identifier for the request. + To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExecutionWindow` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use update_execution_window API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['executionWindowId'] + resource_path = "/executionWindows/{executionWindowId}" + method = "PUT" + operation_name = "update_execution_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExecutionWindow/UpdateExecutionWindow" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"update_execution_window got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "executionWindowId": execution_window_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_execution_window_details, + response_type="ExecutionWindow", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_execution_window_details, + response_type="ExecutionWindow", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def update_external_container_database(self, external_container_database_id, update_external_container_database_details, **kwargs): + """ + Updates the properties of + an :func:`create_external_container_database_details` resource, + such as the display name. + + + :param str external_container_database_id: (required) + The ExternalContainerDatabase `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :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. @@ -39016,33 +43408,33 @@ def update_exadata_iorm_config(self, db_system_id, exadata_iorm_config_update_de allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ExternalContainerDatabase` :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_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['dbSystemId'] - resource_path = "/dbSystems/{dbSystemId}/ExadataIormConfig" + required_arguments = ['externalContainerDatabaseId'] + resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" method = "PUT" - operation_name = "update_exadata_iorm_config" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/DbSystem/UpdateExadataIormConfig" + operation_name = "update_external_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/UpdateExternalContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_exadata_iorm_config got unknown kwargs: {extra_kwargs!r}") + f"update_external_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "dbSystemId": db_system_id + "externalContainerDatabaseId": external_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39054,8 +43446,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} @@ -39074,8 +43466,8 @@ 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_container_database_details, + response_type="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39086,25 +43478,26 @@ 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_container_database_details, + response_type="ExternalContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, **kwargs): + def update_external_database_connector(self, external_database_connector_id, update_external_database_connector_details, **kwargs): """ - Updates the specified Exadata VM cluster on Exascale Infrastructure. Applies to Exadata Database Service on Exascale Infrastructure only. + Updates the properties of an external database connector, such as the display name. - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :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.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) - Request to update the attributes of a Exadata VM cluster on Exascale Infrastructure. + :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` @@ -39126,18 +43519,18 @@ def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_d allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExadbVmCluster` + :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_exadb_vm_cluster API. + Click `here `__ to see an example of how to use update_external_database_connector API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exadbVmClusterId'] - resource_path = "/exadbVmClusters/{exadbVmClusterId}" + required_arguments = ['externalDatabaseConnectorId'] + resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" method = "PUT" - operation_name = "update_exadb_vm_cluster" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExadbVmCluster/UpdateExadbVmCluster" + operation_name = "update_external_database_connector" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/UpdateExternalDatabaseConnector" # Don't accept unknown kwargs expected_kwargs = [ @@ -39149,10 +43542,10 @@ def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_d extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_exadb_vm_cluster got unknown kwargs: {extra_kwargs!r}") + f"update_external_database_connector got unknown kwargs: {extra_kwargs!r}") path_params = { - "exadbVmClusterId": exadb_vm_cluster_id + "externalDatabaseConnectorId": external_database_connector_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39184,8 +43577,8 @@ def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_d method=method, path_params=path_params, header_params=header_params, - body=update_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + body=update_external_database_connector_details, + response_type="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39196,25 +43589,25 @@ def update_exadb_vm_cluster(self, exadb_vm_cluster_id, update_exadb_vm_cluster_d method=method, path_params=path_params, header_params=header_params, - body=update_exadb_vm_cluster_details, - response_type="ExadbVmCluster", + body=update_external_database_connector_details, + response_type="ExternalDatabaseConnector", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, **kwargs): + def update_external_non_container_database(self, external_non_container_database_id, update_external_non_container_database_details, **kwargs): """ - Updates the specified Exadata Database Storage Vault. + Updates the properties of an external non-container database, such as the display name. - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `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.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) - Request to update the attributes of a Exadata Database Storage Vault. + :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` @@ -39236,18 +43629,18 @@ def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_ allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExascaleDbStorageVault` + :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_exascale_db_storage_vault API. + Click `here `__ to see an example of how to use update_external_non_container_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['exascaleDbStorageVaultId'] - resource_path = "/exascaleDbStorageVaults/{exascaleDbStorageVaultId}" + required_arguments = ['externalNonContainerDatabaseId'] + resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" method = "PUT" - operation_name = "update_exascale_db_storage_vault" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExascaleDbStorageVault/UpdateExascaleDbStorageVault" + operation_name = "update_external_non_container_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/UpdateExternalNonContainerDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -39259,10 +43652,10 @@ def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_ extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_exascale_db_storage_vault got unknown kwargs: {extra_kwargs!r}") + f"update_external_non_container_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "exascaleDbStorageVaultId": exascale_db_storage_vault_id + "externalNonContainerDatabaseId": external_non_container_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39294,8 +43687,8 @@ def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_ method=method, path_params=path_params, header_params=header_params, - body=update_exascale_db_storage_vault_details, - response_type="ExascaleDbStorageVault", + body=update_external_non_container_database_details, + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39306,28 +43699,27 @@ def update_exascale_db_storage_vault(self, exascale_db_storage_vault_id, update_ method=method, path_params=path_params, header_params=header_params, - body=update_exascale_db_storage_vault_details, - response_type="ExascaleDbStorageVault", + body=update_external_non_container_database_details, + response_type="ExternalNonContainerDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_external_container_database(self, external_container_database_id, update_external_container_database_details, **kwargs): + def update_external_pluggable_database(self, external_pluggable_database_id, update_external_pluggable_database_details, **kwargs): """ - Updates the properties of - an :func:`create_external_container_database_details` resource, + Updates the properties of an + :func:`create_external_pluggable_database_details` resource, such as the display name. - :param str external_container_database_id: (required) - The ExternalContainerDatabase `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.UpdateExternalContainerDatabaseDetails update_external_container_database_details: (required) - Request to update the properties of an - :func:`create_external_container_database_details` resource. + :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` @@ -39349,18 +43741,18 @@ def update_external_container_database(self, external_container_database_id, upd allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalContainerDatabase` + :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_external_container_database API. + Click `here `__ to see an example of how to use update_external_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalContainerDatabaseId'] - resource_path = "/externalcontainerdatabases/{externalContainerDatabaseId}" + required_arguments = ['externalPluggableDatabaseId'] + resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" method = "PUT" - operation_name = "update_external_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalContainerDatabase/UpdateExternalContainerDatabase" + operation_name = "update_external_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/UpdateExternalPluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ @@ -39372,10 +43764,10 @@ def update_external_container_database(self, external_container_database_id, upd extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_external_container_database got unknown kwargs: {extra_kwargs!r}") + f"update_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalContainerDatabaseId": external_container_database_id + "externalPluggableDatabaseId": external_pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39407,8 +43799,8 @@ def update_external_container_database(self, external_container_database_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_container_database_details, - response_type="ExternalContainerDatabase", + body=update_external_pluggable_database_details, + response_type="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39419,26 +43811,25 @@ def update_external_container_database(self, external_container_database_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_container_database_details, - response_type="ExternalContainerDatabase", + body=update_external_pluggable_database_details, + response_type="ExternalPluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_external_database_connector(self, external_database_connector_id, update_external_database_connector_details, **kwargs): + def update_key_store(self, key_store_id, update_key_store_details, **kwargs): """ - Updates the properties of an external database connector, such as the display name. + Edit the key store. - :param str external_database_connector_id: (required) - The `OCID`__ of the - external database connector resource (`ExternalDatabaseConnectorId`). + :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.UpdateExternalDatabaseConnectorDetails update_external_database_connector_details: (required) - Request to update the properties of an external database connector. + :param oci.database.models.UpdateKeyStoreDetails update_key_store_details: (required) + Request to update the attributes of a key store. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -39460,18 +43851,18 @@ def update_external_database_connector(self, external_database_connector_id, upd allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalDatabaseConnector` + :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 update_external_database_connector API. + Click `here `__ to see an example of how to use update_key_store API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalDatabaseConnectorId'] - resource_path = "/externaldatabaseconnectors/{externalDatabaseConnectorId}" + required_arguments = ['keyStoreId'] + resource_path = "/keyStores/{keyStoreId}" method = "PUT" - operation_name = "update_external_database_connector" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalDatabaseConnector/UpdateExternalDatabaseConnector" + operation_name = "update_key_store" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/UpdateKeyStore" # Don't accept unknown kwargs expected_kwargs = [ @@ -39483,10 +43874,10 @@ def update_external_database_connector(self, external_database_connector_id, upd extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_external_database_connector got unknown kwargs: {extra_kwargs!r}") + f"update_key_store got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalDatabaseConnectorId": external_database_connector_id + "keyStoreId": key_store_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39518,8 +43909,8 @@ def update_external_database_connector(self, external_database_connector_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_database_connector_details, - response_type="ExternalDatabaseConnector", + body=update_key_store_details, + response_type="KeyStore", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39530,34 +43921,29 @@ def update_external_database_connector(self, external_database_connector_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_database_connector_details, - response_type="ExternalDatabaseConnector", + body=update_key_store_details, + response_type="KeyStore", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_external_non_container_database(self, external_non_container_database_id, update_external_non_container_database_details, **kwargs): + def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_details, **kwargs): """ - Updates the properties of an external non-container database, such as the display name. - + Updates the properties of a maintenance run, such as the state of a maintenance run. - :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 maintenance_run_id: (required) + The maintenance run OCID. - :param oci.database.models.UpdateExternalNonContainerDatabaseDetails update_external_non_container_database_details: (required) - Request to update the properties of an external non-container database. + :param oci.database.models.UpdateMaintenanceRunDetails update_maintenance_run_details: (required) + Request to update the properties of a maintenance run. :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. @@ -39570,33 +43956,32 @@ def update_external_non_container_database(self, external_non_container_database allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalNonContainerDatabase` + :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 update_external_non_container_database API. + Click `here `__ to see an example of how to use update_maintenance_run API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalNonContainerDatabaseId'] - resource_path = "/externalnoncontainerdatabases/{externalNonContainerDatabaseId}" + required_arguments = ['maintenanceRunId'] + resource_path = "/maintenanceRuns/{maintenanceRunId}" method = "PUT" - operation_name = "update_external_non_container_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalNonContainerDatabase/UpdateExternalNonContainerDatabase" + operation_name = "update_maintenance_run" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/UpdateMaintenanceRun" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_external_non_container_database got unknown kwargs: {extra_kwargs!r}") + f"update_maintenance_run got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalNonContainerDatabaseId": external_non_container_database_id + "maintenanceRunId": maintenance_run_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39608,8 +43993,7 @@ def update_external_non_container_database(self, external_non_container_database 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} @@ -39628,8 +44012,8 @@ def update_external_non_container_database(self, external_non_container_database method=method, path_params=path_params, header_params=header_params, - body=update_external_non_container_database_details, - response_type="ExternalNonContainerDatabase", + body=update_maintenance_run_details, + response_type="MaintenanceRun", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39640,27 +44024,25 @@ def update_external_non_container_database(self, external_non_container_database method=method, path_params=path_params, header_params=header_params, - body=update_external_non_container_database_details, - response_type="ExternalNonContainerDatabase", + body=update_maintenance_run_details, + response_type="MaintenanceRun", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_external_pluggable_database(self, external_pluggable_database_id, update_external_pluggable_database_details, **kwargs): + def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kwargs): """ - Updates the properties of an - :func:`create_external_pluggable_database_details` resource, - such as the display name. + Updates the properties of the specified one-off patch. - :param str external_pluggable_database_id: (required) - The ExternalPluggableDatabaseId `OCID`__. + :param str oneoff_patch_id: (required) + The one-off patch `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExternalPluggableDatabaseDetails update_external_pluggable_database_details: (required) - Request to update the properties of an external pluggable database resource. + :param oci.database.models.UpdateOneoffPatchDetails update_oneoff_patch_details: (required) + Request to update the properties of a one-off patch. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -39682,18 +44064,18 @@ def update_external_pluggable_database(self, external_pluggable_database_id, upd allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.ExternalPluggableDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OneoffPatch` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_external_pluggable_database API. + Click `here `__ to see an example of how to use update_oneoff_patch API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['externalPluggableDatabaseId'] - resource_path = "/externalpluggabledatabases/{externalPluggableDatabaseId}" + required_arguments = ['oneoffPatchId'] + resource_path = "/oneoffPatches/{oneoffPatchId}" method = "PUT" - operation_name = "update_external_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/ExternalPluggableDatabase/UpdateExternalPluggableDatabase" + operation_name = "update_oneoff_patch" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/UpdateOneoffPatch" # Don't accept unknown kwargs expected_kwargs = [ @@ -39705,10 +44087,10 @@ def update_external_pluggable_database(self, external_pluggable_database_id, upd extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_external_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"update_oneoff_patch got unknown kwargs: {extra_kwargs!r}") path_params = { - "externalPluggableDatabaseId": external_pluggable_database_id + "oneoffPatchId": oneoff_patch_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39740,8 +44122,8 @@ def update_external_pluggable_database(self, external_pluggable_database_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_pluggable_database_details, - response_type="ExternalPluggableDatabase", + body=update_oneoff_patch_details, + response_type="OneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39752,34 +44134,31 @@ def update_external_pluggable_database(self, external_pluggable_database_id, upd method=method, path_params=path_params, header_params=header_params, - body=update_external_pluggable_database_details, - response_type="ExternalPluggableDatabase", + body=update_oneoff_patch_details, + response_type="OneoffPatch", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_key_store(self, key_store_id, update_key_store_details, **kwargs): + def update_pluggable_database(self, pluggable_database_id, update_pluggable_database_details, **kwargs): """ - Edit the key store. + Updates the specified pluggable database. - :param str key_store_id: (required) - The `OCID`__ of the key store. + :param str pluggable_database_id: (required) + The database `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateKeyStoreDetails update_key_store_details: (required) - Request to update the attributes of a key store. + :param oci.database.models.UpdatePluggableDatabaseDetails update_pluggable_database_details: (required) + Request to perform pluggable 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. @@ -39792,33 +44171,32 @@ def update_key_store(self, key_store_id, update_key_store_details, **kwargs): allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.PluggableDatabase` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_key_store API. + Click `here `__ to see an example of how to use update_pluggable_database API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['keyStoreId'] - resource_path = "/keyStores/{keyStoreId}" + required_arguments = ['pluggableDatabaseId'] + resource_path = "/pluggableDatabases/{pluggableDatabaseId}" method = "PUT" - operation_name = "update_key_store" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/KeyStore/UpdateKeyStore" + operation_name = "update_pluggable_database" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/UpdatePluggableDatabase" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_key_store got unknown kwargs: {extra_kwargs!r}") + f"update_pluggable_database got unknown kwargs: {extra_kwargs!r}") path_params = { - "keyStoreId": key_store_id + "pluggableDatabaseId": pluggable_database_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39830,8 +44208,7 @@ def update_key_store(self, key_store_id, update_key_store_details, **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} @@ -39850,8 +44227,8 @@ def update_key_store(self, key_store_id, update_key_store_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_key_store_details, - response_type="KeyStore", + body=update_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39862,29 +44239,34 @@ def update_key_store(self, key_store_id, update_key_store_details, **kwargs): method=method, path_params=path_params, header_params=header_params, - body=update_key_store_details, - response_type="KeyStore", + body=update_pluggable_database_details, + response_type="PluggableDatabase", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_details, **kwargs): + def update_scheduled_action(self, scheduled_action_id, update_scheduled_action_details, **kwargs): """ - Updates the properties of a maintenance run, such as the state of a maintenance run. + Updates the Scheduled Action resource. - :param str maintenance_run_id: (required) - The maintenance run OCID. + :param str scheduled_action_id: (required) + The Scheduled Action `OCID`__. - :param oci.database.models.UpdateMaintenanceRunDetails update_maintenance_run_details: (required) - Request to update the properties of a maintenance run. + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateScheduledActionDetails update_scheduled_action_details: (required) + Request to update the properties of a Scheduled Action. :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. @@ -39897,32 +44279,33 @@ def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_deta allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :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.ScheduledAction` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_maintenance_run API. + Click `here `__ to see an example of how to use update_scheduled_action API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['maintenanceRunId'] - resource_path = "/maintenanceRuns/{maintenanceRunId}" + required_arguments = ['scheduledActionId'] + resource_path = "/scheduledActions/{scheduledActionId}" method = "PUT" - operation_name = "update_maintenance_run" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/MaintenanceRun/UpdateMaintenanceRun" + operation_name = "update_scheduled_action" + api_reference_link = "" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_maintenance_run got unknown kwargs: {extra_kwargs!r}") + f"update_scheduled_action got unknown kwargs: {extra_kwargs!r}") path_params = { - "maintenanceRunId": maintenance_run_id + "scheduledActionId": scheduled_action_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -39934,7 +44317,8 @@ def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_deta 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} @@ -39953,8 +44337,8 @@ def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_deta method=method, path_params=path_params, header_params=header_params, - body=update_maintenance_run_details, - response_type="MaintenanceRun", + body=update_scheduled_action_details, + response_type="ScheduledAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -39965,25 +44349,25 @@ def update_maintenance_run(self, maintenance_run_id, update_maintenance_run_deta method=method, path_params=path_params, header_params=header_params, - body=update_maintenance_run_details, - response_type="MaintenanceRun", + body=update_scheduled_action_details, + response_type="ScheduledAction", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kwargs): + def update_scheduling_policy(self, scheduling_policy_id, update_scheduling_policy_details, **kwargs): """ - Updates the properties of the specified one-off patch. + Updates the Scheduling Policy resource. - :param str oneoff_patch_id: (required) - The one-off patch `OCID`__. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateOneoffPatchDetails update_oneoff_patch_details: (required) - Request to update the properties of a one-off patch. + :param oci.database.models.UpdateSchedulingPolicyDetails update_scheduling_policy_details: (required) + Request to update the properties of a Scheduling Policy. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` @@ -40005,18 +44389,18 @@ def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.OneoffPatch` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingPolicy` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_oneoff_patch API. + Click `here `__ to see an example of how to use update_scheduling_policy API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['oneoffPatchId'] - resource_path = "/oneoffPatches/{oneoffPatchId}" + required_arguments = ['schedulingPolicyId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}" method = "PUT" - operation_name = "update_oneoff_patch" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/OneoffPatch/UpdateOneoffPatch" + operation_name = "update_scheduling_policy" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingPolicy/UpdateSchedulingPolicy" # Don't accept unknown kwargs expected_kwargs = [ @@ -40028,10 +44412,10 @@ def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kw extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"update_oneoff_patch got unknown kwargs: {extra_kwargs!r}") + f"update_scheduling_policy got unknown kwargs: {extra_kwargs!r}") path_params = { - "oneoffPatchId": oneoff_patch_id + "schedulingPolicyId": scheduling_policy_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -40063,8 +44447,8 @@ def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kw method=method, path_params=path_params, header_params=header_params, - body=update_oneoff_patch_details, - response_type="OneoffPatch", + body=update_scheduling_policy_details, + response_type="SchedulingPolicy", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -40075,31 +44459,39 @@ def update_oneoff_patch(self, oneoff_patch_id, update_oneoff_patch_details, **kw method=method, path_params=path_params, header_params=header_params, - body=update_oneoff_patch_details, - response_type="OneoffPatch", + body=update_scheduling_policy_details, + response_type="SchedulingPolicy", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, required_arguments=required_arguments) - def update_pluggable_database(self, pluggable_database_id, update_pluggable_database_details, **kwargs): + def update_scheduling_window(self, scheduling_policy_id, scheduling_window_id, update_scheduling_window_details, **kwargs): """ - Updates the specified pluggable database. + Updates the Scheduling Window resource. - :param str pluggable_database_id: (required) - The database `OCID`__. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdatePluggableDatabaseDetails update_pluggable_database_details: (required) - Request to perform pluggable database update. + :param str scheduling_window_id: (required) + The Scheduling Window `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateSchedulingWindowDetails update_scheduling_window_details: (required) + Request to update the properties of a Scheduling Window. :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. @@ -40112,32 +44504,34 @@ def update_pluggable_database(self, pluggable_database_id, update_pluggable_data allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.PluggableDatabase` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.database.models.SchedulingWindow` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use update_pluggable_database API. + Click `here `__ to see an example of how to use update_scheduling_window API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['pluggableDatabaseId'] - resource_path = "/pluggableDatabases/{pluggableDatabaseId}" + required_arguments = ['schedulingPolicyId', 'schedulingWindowId'] + resource_path = "/schedulingPolicies/{schedulingPolicyId}/schedulingWindows/{schedulingWindowId}" method = "PUT" - operation_name = "update_pluggable_database" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/PluggableDatabase/UpdatePluggableDatabase" + operation_name = "update_scheduling_window" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database/20160918/SchedulingWindow/UpdateSchedulingWindow" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "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( - f"update_pluggable_database got unknown kwargs: {extra_kwargs!r}") + f"update_scheduling_window got unknown kwargs: {extra_kwargs!r}") path_params = { - "pluggableDatabaseId": pluggable_database_id + "schedulingPolicyId": scheduling_policy_id, + "schedulingWindowId": scheduling_window_id } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -40149,7 +44543,8 @@ def update_pluggable_database(self, pluggable_database_id, update_pluggable_data 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} @@ -40168,8 +44563,8 @@ def update_pluggable_database(self, pluggable_database_id, update_pluggable_data method=method, path_params=path_params, header_params=header_params, - body=update_pluggable_database_details, - response_type="PluggableDatabase", + body=update_scheduling_window_details, + response_type="SchedulingWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -40180,8 +44575,8 @@ def update_pluggable_database(self, pluggable_database_id, update_pluggable_data method=method, path_params=path_params, header_params=header_params, - body=update_pluggable_database_details, - response_type="PluggableDatabase", + body=update_scheduling_window_details, + response_type="SchedulingWindow", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, diff --git a/src/oci/database/database_client_composite_operations.py b/src/oci/database/database_client_composite_operations.py index 508bf109ea..2dacac155b 100644 --- a/src/oci/database/database_client_composite_operations.py +++ b/src/oci/database/database_client_composite_operations.py @@ -583,6 +583,132 @@ def cancel_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 cancel_execution_window_and_wait_for_work_request(self, execution_window_id, cancel_execution_window_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.cancel_execution_window` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str execution_window_id: (required) + The execution window `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CancelExecutionWindowDetails cancel_execution_window_details: (required) + Request to cancel the in progress maintenance activity under this execution window. + + :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.cancel_execution_window` + + :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.cancel_execution_window(execution_window_id, cancel_execution_window_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 cancel_execution_window_and_wait_for_state(self, execution_window_id, cancel_execution_window_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.cancel_execution_window` and waits for the :py:class:`~oci.database.models.ExecutionWindow` acted upon + to enter the given state(s). + + :param str execution_window_id: (required) + The execution window `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CancelExecutionWindowDetails cancel_execution_window_details: (required) + Request to cancel the in progress maintenance activity under this execution window. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionWindow.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.cancel_execution_window` + + :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.cancel_execution_window(execution_window_id, cancel_execution_window_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + execution_window_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_execution_window(execution_window_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def cascading_delete_scheduling_plan_and_wait_for_work_request(self, scheduling_plan_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.cascading_delete_scheduling_plan` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduling_plan_id: (required) + The Schedule Plan `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.cascading_delete_scheduling_plan` + + :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.cascading_delete_scheduling_plan(scheduling_plan_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_autonomous_container_database_compartment_and_wait_for_work_request(self, change_compartment_details, autonomous_container_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.change_autonomous_container_database_compartment` and waits for the oci.work_requests.models.WorkRequest @@ -1711,6 +1837,88 @@ def change_oneoff_patch_compartment_and_wait_for_work_request(self, change_compa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def change_scheduling_plan_compartment_and_wait_for_work_request(self, change_scheduling_plan_compartment_details, scheduling_plan_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.change_scheduling_plan_compartment` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.ChangeSchedulingPlanCompartmentDetails change_scheduling_plan_compartment_details: (required) + Request to move scheduling plan to a different compartment + + :param str scheduling_plan_id: (required) + The Schedule Plan `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_scheduling_plan_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_scheduling_plan_compartment(change_scheduling_plan_compartment_details, scheduling_plan_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_scheduling_policy_compartment_and_wait_for_work_request(self, change_scheduling_policy_compartment_details, scheduling_policy_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.change_scheduling_policy_compartment` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.ChangeSchedulingPolicyCompartmentDetails change_scheduling_policy_compartment_details: (required) + Request to move scheduling policy to a different compartment + + :param str scheduling_policy_id: (required) + The Scheduling Policy `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_scheduling_policy_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_scheduling_policy_compartment(change_scheduling_policy_compartment_details, scheduling_policy_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_vm_cluster_compartment_and_wait_for_work_request(self, change_vm_cluster_compartment_details, vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.change_vm_cluster_compartment` and waits for the oci.work_requests.models.WorkRequest @@ -3831,62 +4039,26 @@ def create_exascale_db_storage_vault_and_wait_for_state(self, create_exascale_db except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_external_backup_job_and_wait_for_work_request(self, create_external_backup_job_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): - """ - Calls :py:func:`~oci.database.DatabaseClient.create_external_backup_job` and waits for the oci.work_requests.models.WorkRequest - to enter the given state(s). - - :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 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_backup_job` - - :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_backup_job(create_external_backup_job_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] - if 'opc-work-request-id' not in operation_result.headers: - return operation_result - 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_work_request(self, create_external_container_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_execution_action_and_wait_for_work_request(self, create_execution_action_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_external_container_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_execution_action` and waits for the oci.work_requests.models.WorkRequest 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 oci.database.models.CreateExecutionActionDetails create_execution_action_details: (required) + Request to create execution action. :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` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_execution_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.create_external_container_database(create_external_container_database_details, **operation_kwargs) + operation_result = self.client.create_execution_action(create_execution_action_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] if 'opc-work-request-id' not in operation_result.headers: @@ -3903,34 +4075,34 @@ def create_external_container_database_and_wait_for_work_request(self, create_ex 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={}): + def create_execution_action_and_wait_for_state(self, create_execution_action_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 + Calls :py:func:`~oci.database.DatabaseClient.create_execution_action` and waits for the :py:class:`~oci.database.models.ExecutionAction` 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 oci.database.models.CreateExecutionActionDetails create_execution_action_details: (required) + Request to create execution action. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalContainerDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionAction.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_execution_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.create_external_container_database(create_external_container_database_details, **operation_kwargs) + operation_result = self.client.create_execution_action(create_execution_action_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - external_container_database_id = operation_result.data.id + execution_action_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_external_container_database(external_container_database_id), # noqa: F821 + self.client.get_execution_action(execution_action_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -3945,26 +4117,26 @@ def create_external_container_database_and_wait_for_state(self, create_external_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_external_database_connector_and_wait_for_work_request(self, create_external_database_connector_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_execution_window_and_wait_for_work_request(self, create_execution_window_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_external_database_connector` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_execution_window` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) - Request to create a connector to an external database. + :param oci.database.models.CreateExecutionWindowDetails create_execution_window_details: (required) + Request to create execution window. :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_database_connector` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_execution_window` :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_database_connector(create_external_database_connector_details, **operation_kwargs) + operation_result = self.client.create_execution_window(create_execution_window_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] if 'opc-work-request-id' not in operation_result.headers: @@ -3981,34 +4153,34 @@ def create_external_database_connector_and_wait_for_work_request(self, create_ex except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_external_database_connector_and_wait_for_state(self, create_external_database_connector_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_execution_window_and_wait_for_state(self, create_execution_window_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_external_database_connector` and waits for the :py:class:`~oci.database.models.ExternalDatabaseConnector` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_execution_window` and waits for the :py:class:`~oci.database.models.ExecutionWindow` acted upon to enter the given state(s). - :param oci.database.models.CreateExternalDatabaseConnectorDetails create_external_database_connector_details: (required) - Request to create a connector to an external database. + :param oci.database.models.CreateExecutionWindowDetails create_execution_window_details: (required) + Request to create execution window. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExternalDatabaseConnector.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionWindow.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_database_connector` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_execution_window` :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_database_connector(create_external_database_connector_details, **operation_kwargs) + operation_result = self.client.create_execution_window(create_execution_window_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - external_database_connector_id = operation_result.data.id + execution_window_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_external_database_connector(external_database_connector_id), # noqa: F821 + self.client.get_execution_window(execution_window_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4023,26 +4195,26 @@ def create_external_database_connector_and_wait_for_state(self, create_external_ except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - 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={}): + def create_external_backup_job_and_wait_for_work_request(self, create_external_backup_job_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_external_backup_job` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreateExternalNonContainerDatabaseDetails create_external_non_container_database_details: (required) - Request to create a new external non-container database. + :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 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_non_container_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_backup_job` :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_non_container_database(create_external_non_container_database_details, **operation_kwargs) + operation_result = self.client.create_external_backup_job(create_external_backup_job_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] if 'opc-work-request-id' not in operation_result.headers: @@ -4059,16 +4231,208 @@ def create_external_non_container_database_and_wait_for_work_request(self, creat except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_external_non_container_database_and_wait_for_state(self, create_external_non_container_database_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_external_non_container_database` and waits for the :py:class:`~oci.database.models.ExternalNonContainerDatabase` 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.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.ExternalNonContainerDatabase.lifecycle_state` + :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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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.ExternalContainerDatabase.lifecycle_state` + + :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) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + external_container_database_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_external_container_database(external_container_database_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + 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_external_database_connector` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :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_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_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_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_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.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.ExternalDatabaseConnector.lifecycle_state` + + :param dict operation_kwargs: + 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_external_database_connector(create_external_database_connector_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + external_database_connector_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_external_database_connector(external_database_connector_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + 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_external_non_container_database` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :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_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_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_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_external_non_container_database` and waits for the :py:class:`~oci.database.models.ExternalNonContainerDatabase` acted upon + to enter the given state(s). + + :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.ExternalNonContainerDatabase.lifecycle_state` :param dict operation_kwargs: A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_external_non_container_database` @@ -4200,55 +4564,367 @@ def create_key_store_and_wait_for_state(self, create_key_store_details, wait_for 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] - key_store_id = operation_result.data.id - + lowered_wait_for_states = [w.lower() for w in wait_for_states] + key_store_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_key_store(key_store_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_maintenance_run_and_wait_for_state(self, create_maintenance_run_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_maintenance_run` and waits for the :py:class:`~oci.database.models.MaintenanceRun` acted upon + to enter the given state(s). + + :param oci.database.models.CreateMaintenanceRunDetails create_maintenance_run_details: (required) + Request to create a Maintenance Run for the 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.MaintenanceRun.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_maintenance_run` + + :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_maintenance_run(create_maintenance_run_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + maintenance_run_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_maintenance_run(maintenance_run_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_oneoff_patch_and_wait_for_work_request(self, create_oneoff_patch_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) + Request to create a one-off patch to download. + + :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_oneoff_patch` + + :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_oneoff_patch(create_oneoff_patch_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_oneoff_patch_and_wait_for_state(self, create_oneoff_patch_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` and waits for the :py:class:`~oci.database.models.OneoffPatch` acted upon + to enter the given state(s). + + :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) + Request to create a one-off patch to download. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.OneoffPatch.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` + + :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_oneoff_patch(create_oneoff_patch_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + oneoff_patch_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_oneoff_patch(oneoff_patch_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_pluggable_database_and_wait_for_work_request(self, create_pluggable_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_pluggable_database` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) + Request to create 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.create_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.create_pluggable_database(create_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_pluggable_database_and_wait_for_state(self, create_pluggable_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_pluggable_database` and waits for the :py:class:`~oci.database.models.PluggableDatabase` acted upon + to enter the given state(s). + + :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) + Request to create 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.PluggableDatabase.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_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.create_pluggable_database(create_pluggable_database_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + pluggable_database_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_pluggable_database(pluggable_database_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_scheduled_action_and_wait_for_work_request(self, create_scheduled_action_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_scheduled_action` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.CreateScheduledActionDetails create_scheduled_action_details: (required) + Request to create Scheduled Action. + + :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_scheduled_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.create_scheduled_action(create_scheduled_action_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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_scheduled_action_and_wait_for_state(self, create_scheduled_action_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_scheduled_action` and waits for the :py:class:`~oci.database.models.ScheduledAction` acted upon + to enter the given state(s). + + :param oci.database.models.CreateScheduledActionDetails create_scheduled_action_details: (required) + Request to create Scheduled Action. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ScheduledAction.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduled_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.create_scheduled_action(create_scheduled_action_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + scheduled_action_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_scheduled_action(scheduled_action_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def create_scheduling_plan_and_wait_for_work_request(self, create_scheduling_plan_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_plan` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.CreateSchedulingPlanDetails create_scheduling_plan_details: (required) + Request to create Scheduling Plan. + + :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_scheduling_plan` + + :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_scheduling_plan(create_scheduling_plan_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + work_request_id = operation_result.headers['opc-work-request-id'] try: waiter_result = oci.wait_until( - self.client, - self.client.get_key_store(key_store_id), # noqa: F821 - 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 - except (NameError, TypeError) as e: - if not e.args: - e.args = ('',) - e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) - raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + return waiter_result except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_maintenance_run_and_wait_for_state(self, create_maintenance_run_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_scheduling_plan_and_wait_for_state(self, create_scheduling_plan_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_maintenance_run` and waits for the :py:class:`~oci.database.models.MaintenanceRun` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_plan` and waits for the :py:class:`~oci.database.models.SchedulingPlan` acted upon to enter the given state(s). - :param oci.database.models.CreateMaintenanceRunDetails create_maintenance_run_details: (required) - Request to create a Maintenance Run for the resource. + :param oci.database.models.CreateSchedulingPlanDetails create_scheduling_plan_details: (required) + Request to create Scheduling Plan. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.MaintenanceRun.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingPlan.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_maintenance_run` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduling_plan` :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_maintenance_run(create_maintenance_run_details, **operation_kwargs) + operation_result = self.client.create_scheduling_plan(create_scheduling_plan_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - maintenance_run_id = operation_result.data.id + scheduling_plan_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_maintenance_run(maintenance_run_id), # noqa: F821 + self.client.get_scheduling_plan(scheduling_plan_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4263,26 +4939,26 @@ def create_maintenance_run_and_wait_for_state(self, create_maintenance_run_detai except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_oneoff_patch_and_wait_for_work_request(self, create_oneoff_patch_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_scheduling_policy_and_wait_for_work_request(self, create_scheduling_policy_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_policy` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) - Request to create a one-off patch to download. + :param oci.database.models.CreateSchedulingPolicyDetails create_scheduling_policy_details: (required) + Request to create Scheduling Policy. :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_oneoff_patch` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduling_policy` :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_oneoff_patch(create_oneoff_patch_details, **operation_kwargs) + operation_result = self.client.create_scheduling_policy(create_scheduling_policy_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] if 'opc-work-request-id' not in operation_result.headers: @@ -4299,34 +4975,34 @@ def create_oneoff_patch_and_wait_for_work_request(self, create_oneoff_patch_deta except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_oneoff_patch_and_wait_for_state(self, create_oneoff_patch_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_scheduling_policy_and_wait_for_state(self, create_scheduling_policy_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` and waits for the :py:class:`~oci.database.models.OneoffPatch` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_policy` and waits for the :py:class:`~oci.database.models.SchedulingPolicy` acted upon to enter the given state(s). - :param oci.database.models.CreateOneoffPatchDetails create_oneoff_patch_details: (required) - Request to create a one-off patch to download. + :param oci.database.models.CreateSchedulingPolicyDetails create_scheduling_policy_details: (required) + Request to create Scheduling Policy. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.OneoffPatch.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingPolicy.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_oneoff_patch` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduling_policy` :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_oneoff_patch(create_oneoff_patch_details, **operation_kwargs) + operation_result = self.client.create_scheduling_policy(create_scheduling_policy_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - oneoff_patch_id = operation_result.data.id + scheduling_policy_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_oneoff_patch(oneoff_patch_id), # noqa: F821 + self.client.get_scheduling_policy(scheduling_policy_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -4341,26 +5017,31 @@ def create_oneoff_patch_and_wait_for_state(self, create_oneoff_patch_details, wa except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_pluggable_database_and_wait_for_work_request(self, create_pluggable_database_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_scheduling_window_and_wait_for_work_request(self, scheduling_policy_id, create_scheduling_window_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_pluggable_database` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_window` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) - Request to create pluggable database. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CreateSchedulingWindowDetails create_scheduling_window_details: (required) + Request to create Scheduling Window. :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_pluggable_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduling_window` :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_pluggable_database(create_pluggable_database_details, **operation_kwargs) + operation_result = self.client.create_scheduling_window(scheduling_policy_id, create_scheduling_window_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] if 'opc-work-request-id' not in operation_result.headers: @@ -4377,34 +5058,39 @@ def create_pluggable_database_and_wait_for_work_request(self, create_pluggable_d except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def create_pluggable_database_and_wait_for_state(self, create_pluggable_database_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def create_scheduling_window_and_wait_for_state(self, scheduling_policy_id, create_scheduling_window_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.create_pluggable_database` and waits for the :py:class:`~oci.database.models.PluggableDatabase` acted upon + Calls :py:func:`~oci.database.DatabaseClient.create_scheduling_window` and waits for the :py:class:`~oci.database.models.SchedulingWindow` acted upon to enter the given state(s). - :param oci.database.models.CreatePluggableDatabaseDetails create_pluggable_database_details: (required) - Request to create pluggable database. + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.CreateSchedulingWindowDetails create_scheduling_window_details: (required) + Request to create Scheduling Window. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.PluggableDatabase.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingWindow.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_pluggable_database` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.create_scheduling_window` :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_pluggable_database(create_pluggable_database_details, **operation_kwargs) + operation_result = self.client.create_scheduling_window(scheduling_policy_id, create_scheduling_window_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - pluggable_database_id = operation_result.data.id + scheduling_window_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_pluggable_database(pluggable_database_id), # noqa: F821 + self.client.get_scheduling_window(scheduling_policy_id, scheduling_window_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -5392,6 +6078,105 @@ def delete_exascale_db_storage_vault_and_wait_for_work_request(self, exascale_db except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def delete_execution_action_and_wait_for_work_request(self, execution_action_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_execution_action` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str execution_action_id: (required) + The execution action `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_execution_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_execution_action(execution_action_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 delete_execution_window_and_wait_for_state(self, execution_window_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_execution_window` and waits for the :py:class:`~oci.database.models.ExecutionWindow` acted upon + to enter the given state(s). + + :param str execution_window_id: (required) + The execution window `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.ExecutionWindow.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_execution_window` + + :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_execution_window(execution_window_id) + operation_result = None + try: + operation_result = self.client.delete_execution_window(execution_window_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: + if ("succeed_on_not_found" in waiter_kwargs) and (waiter_kwargs["succeed_on_not_found"] is False): + self.client.base_client.logger.warning("The waiter kwarg succeed_on_not_found was passed as False for the delete composite operation delete_execution_window, this would result in the operation to fail if the resource is not found! Please, do not pass this kwarg if this was not intended") + else: + """ + If the user does not send in this value, we set it to True by default. + We are doing this because during a delete resource scenario and waiting on its state, the service can + return a 404 NOT FOUND exception as the resource was deleted and a get on its state would fail + """ + waiter_kwargs["succeed_on_not_found"] = True + waiter_result = oci.wait_until( + self.client, + initial_get_result, # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + 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.delete_external_container_database` and waits for the oci.work_requests.models.WorkRequest @@ -5678,7 +6463,144 @@ def delete_pluggable_database_and_wait_for_work_request(self, pluggable_database evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').lower() in lowered_work_request_states, **waiter_kwargs ) - return waiter_result + return waiter_result + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def delete_scheduled_action_and_wait_for_work_request(self, scheduled_action_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_scheduled_action` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduled_action_id: (required) + The Scheduled Action `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_scheduled_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_scheduled_action(scheduled_action_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 delete_scheduling_plan_and_wait_for_work_request(self, scheduling_plan_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_scheduling_plan` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduling_plan_id: (required) + The Schedule Plan `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_scheduling_plan` + + :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_scheduling_plan(scheduling_plan_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 delete_scheduling_policy_and_wait_for_state(self, scheduling_policy_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.delete_scheduling_policy` and waits for the :py:class:`~oci.database.models.SchedulingPolicy` acted upon + to enter the given state(s). + + :param str scheduling_policy_id: (required) + The Scheduling Policy `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.SchedulingPolicy.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.delete_scheduling_policy` + + :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_scheduling_policy(scheduling_policy_id) + operation_result = None + try: + operation_result = self.client.delete_scheduling_policy(scheduling_policy_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: + if ("succeed_on_not_found" in waiter_kwargs) and (waiter_kwargs["succeed_on_not_found"] is False): + self.client.base_client.logger.warning("The waiter kwarg succeed_on_not_found was passed as False for the delete composite operation delete_scheduling_policy, this would result in the operation to fail if the resource is not found! Please, do not pass this kwarg if this was not intended") + else: + """ + If the user does not send in this value, we set it to True by default. + We are doing this because during a delete resource scenario and waiting on its state, the service can + return a 404 NOT FOUND exception as the resource was deleted and a get on its state would fail + """ + waiter_kwargs["succeed_on_not_found"] = True + waiter_result = oci.wait_until( + self.client, + initial_get_result, # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) @@ -7757,6 +8679,94 @@ def modify_pluggable_database_management_and_wait_for_state(self, pluggable_data except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def move_execution_action_member_and_wait_for_work_request(self, execution_action_id, move_execution_action_member_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.move_execution_action_member` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str execution_action_id: (required) + The execution action `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.MoveExecutionActionMemberDetails move_execution_action_member_details: (required) + Request to move an execution action member to this execution action resource from another. + + :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.move_execution_action_member` + + :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.move_execution_action_member(execution_action_id, move_execution_action_member_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 move_execution_action_member_and_wait_for_state(self, execution_action_id, move_execution_action_member_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.move_execution_action_member` and waits for the :py:class:`~oci.database.models.ExecutionAction` acted upon + to enter the given state(s). + + :param str execution_action_id: (required) + The execution action `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.MoveExecutionActionMemberDetails move_execution_action_member_details: (required) + Request to move an execution action member to this execution action resource from another. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionAction.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.move_execution_action_member` + + :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.move_execution_action_member(execution_action_id, move_execution_action_member_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + execution_action_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_execution_action(execution_action_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def refresh_pluggable_database_and_wait_for_work_request(self, pluggable_database_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.refresh_pluggable_database` and waits for the oci.work_requests.models.WorkRequest @@ -8155,16 +9165,192 @@ def remote_clone_pluggable_database_and_wait_for_state(self, remote_clone_plugga except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) + Request to remove Virtual Machines from the Cloud 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 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.remove_virtual_machine_from_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.remove_virtual_machine_from_cloud_vm_cluster(remove_virtual_machine_from_cloud_vm_cluster_details, 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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_cloud_vm_cluster` and waits for the :py:class:`~oci.database.models.CloudVmCluster` acted upon + to enter the given state(s). + + :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) + Request to remove Virtual Machines from the Cloud 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 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.remove_virtual_machine_from_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.remove_virtual_machine_from_cloud_vm_cluster(remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + cloud_vm_cluster_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_cloud_vm_cluster(cloud_vm_cluster_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) + Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. + + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + + __ 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.remove_virtual_machine_from_exadb_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.remove_virtual_machine_from_exadb_vm_cluster(remove_virtual_machine_from_exadb_vm_cluster_details, exadb_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_vm_cluster` and waits for the :py:class:`~oci.database.models.ExadbVmCluster` acted upon + to enter the given state(s). + + :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) + Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. + + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + + __ 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.ExadbVmCluster.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_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.remove_virtual_machine_from_exadb_vm_cluster(remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + exadb_vm_cluster_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_exadb_vm_cluster(exadb_vm_cluster_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def remove_virtual_machine_from_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_cloud_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_vm_cluster` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) - Request to remove Virtual Machines from the Cloud VM cluster. + :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) + Request to remove Virtual Machines from the VM cluster. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -8173,13 +9359,13 @@ def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_work_request(self, 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.remove_virtual_machine_from_cloud_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_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.remove_virtual_machine_from_cloud_vm_cluster(remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **operation_kwargs) + operation_result = self.client.remove_virtual_machine_from_vm_cluster(remove_virtual_machine_from_vm_cluster_details, 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] if 'opc-work-request-id' not in operation_result.headers: @@ -8196,39 +9382,39 @@ def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_work_request(self, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def remove_virtual_machine_from_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_cloud_vm_cluster` and waits for the :py:class:`~oci.database.models.CloudVmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_vm_cluster` and waits for the :py:class:`~oci.database.models.VmCluster` acted upon to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromCloudVmClusterDetails remove_virtual_machine_from_cloud_vm_cluster_details: (required) - Request to remove Virtual Machines from the Cloud VM cluster. + :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) + Request to remove Virtual Machines from the VM cluster. - :param str cloud_vm_cluster_id: (required) - The cloud VM cluster `OCID`__. + :param str vm_cluster_id: (required) + The VM cluster `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.CloudVmCluster.lifecycle_state` + 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.remove_virtual_machine_from_cloud_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_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.remove_virtual_machine_from_cloud_vm_cluster(remove_virtual_machine_from_cloud_vm_cluster_details, cloud_vm_cluster_id, **operation_kwargs) + operation_result = self.client.remove_virtual_machine_from_vm_cluster(remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - cloud_vm_cluster_id = operation_result.data.id + vm_cluster_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_cloud_vm_cluster(cloud_vm_cluster_id), # noqa: F821 + self.client.get_vm_cluster(vm_cluster_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -8243,31 +9429,31 @@ def remove_virtual_machine_from_cloud_vm_cluster_and_wait_for_state(self, remove except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def reorder_execution_actions_and_wait_for_work_request(self, execution_window_id, reorder_execution_action_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.reorder_execution_actions` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) - Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. - - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str execution_window_id: (required) + The execution window `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.ReorderExecutionActionDetails reorder_execution_action_details: (required) + Request to reorder the execution actions under this execution window 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.remove_virtual_machine_from_exadb_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reorder_execution_actions` :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.remove_virtual_machine_from_exadb_vm_cluster(remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **operation_kwargs) + operation_result = self.client.reorder_execution_actions(execution_window_id, reorder_execution_action_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] if 'opc-work-request-id' not in operation_result.headers: @@ -8284,39 +9470,39 @@ def remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_work_request(self, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def reorder_execution_actions_and_wait_for_state(self, execution_window_id, reorder_execution_action_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_vm_cluster` and waits for the :py:class:`~oci.database.models.ExadbVmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.reorder_execution_actions` and waits for the :py:class:`~oci.database.models.ExecutionWindow` acted upon to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromExadbVmClusterDetails remove_virtual_machine_from_exadb_vm_cluster_details: (required) - Request to remove Virtual Machines from the Exadata VM cluster on Exascale Infrastructure. - - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str execution_window_id: (required) + The execution window `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + :param oci.database.models.ReorderExecutionActionDetails reorder_execution_action_details: (required) + Request to reorder the execution actions under this execution window 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.ExadbVmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionWindow.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_exadb_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reorder_execution_actions` :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.remove_virtual_machine_from_exadb_vm_cluster(remove_virtual_machine_from_exadb_vm_cluster_details, exadb_vm_cluster_id, **operation_kwargs) + operation_result = self.client.reorder_execution_actions(execution_window_id, reorder_execution_action_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - exadb_vm_cluster_id = operation_result.data.id + execution_window_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_exadb_vm_cluster(exadb_vm_cluster_id), # noqa: F821 + self.client.get_execution_window(execution_window_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -8331,16 +9517,16 @@ def remove_virtual_machine_from_exadb_vm_cluster_and_wait_for_state(self, remove except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_vm_cluster_and_wait_for_work_request(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def reorder_scheduled_actions_and_wait_for_work_request(self, reorder_scheduled_actions_details, scheduling_plan_id, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.reorder_scheduled_actions` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) - Request to remove Virtual Machines from the VM cluster. + :param oci.database.models.ReorderScheduledActionsDetails reorder_scheduled_actions_details: (required) + Request to re-order Scheduled Action resources. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str scheduling_plan_id: (required) + The Schedule Plan `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -8349,13 +9535,13 @@ def remove_virtual_machine_from_vm_cluster_and_wait_for_work_request(self, remov 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.remove_virtual_machine_from_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reorder_scheduled_actions` :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.remove_virtual_machine_from_vm_cluster(remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **operation_kwargs) + operation_result = self.client.reorder_scheduled_actions(reorder_scheduled_actions_details, scheduling_plan_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] if 'opc-work-request-id' not in operation_result.headers: @@ -8372,39 +9558,39 @@ def remove_virtual_machine_from_vm_cluster_and_wait_for_work_request(self, remov except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def remove_virtual_machine_from_vm_cluster_and_wait_for_state(self, remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def reorder_scheduled_actions_and_wait_for_state(self, reorder_scheduled_actions_details, scheduling_plan_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_vm_cluster` and waits for the :py:class:`~oci.database.models.VmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.reorder_scheduled_actions` and waits for the :py:class:`~oci.database.models.SchedulingPlan` acted upon to enter the given state(s). - :param oci.database.models.RemoveVirtualMachineFromVmClusterDetails remove_virtual_machine_from_vm_cluster_details: (required) - Request to remove Virtual Machines from the VM cluster. + :param oci.database.models.ReorderScheduledActionsDetails reorder_scheduled_actions_details: (required) + Request to re-order Scheduled Action resources. - :param str vm_cluster_id: (required) - The VM cluster `OCID`__. + :param str scheduling_plan_id: (required) + The Schedule Plan `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.VmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingPlan.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.remove_virtual_machine_from_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.reorder_scheduled_actions` :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.remove_virtual_machine_from_vm_cluster(remove_virtual_machine_from_vm_cluster_details, vm_cluster_id, **operation_kwargs) + operation_result = self.client.reorder_scheduled_actions(reorder_scheduled_actions_details, scheduling_plan_id, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - vm_cluster_id = operation_result.data.id + scheduling_plan_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_vm_cluster(vm_cluster_id), # noqa: F821 + self.client.get_scheduling_plan(scheduling_plan_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -12071,12 +13257,188 @@ def update_exadata_iorm_config_and_wait_for_state(self, db_system_id, exadata_io if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - db_system_id = operation_result.data.id + db_system_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_exadata_iorm_config(db_system_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_exadb_vm_cluster_and_wait_for_work_request(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_exadb_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) + Request to update the attributes of a Exadata VM cluster on Exascale 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_exadb_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_exadb_vm_cluster(exadb_vm_cluster_id, update_exadb_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 update_exadb_vm_cluster_and_wait_for_state(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_exadb_vm_cluster` and waits for the :py:class:`~oci.database.models.ExadbVmCluster` acted upon + to enter the given state(s). + + :param str exadb_vm_cluster_id: (required) + The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) + Request to update the attributes of a Exadata VM cluster on Exascale 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.ExadbVmCluster.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadb_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_exadb_vm_cluster(exadb_vm_cluster_id, update_exadb_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] + exadb_vm_cluster_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_exadb_vm_cluster(exadb_vm_cluster_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_exascale_db_storage_vault_and_wait_for_work_request(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) + Request to update the attributes of a Exadata Database Storage Vault. + + :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_exascale_db_storage_vault` + + :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_exascale_db_storage_vault(exascale_db_storage_vault_id, update_exascale_db_storage_vault_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 update_exascale_db_storage_vault_and_wait_for_state(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` and waits for the :py:class:`~oci.database.models.ExascaleDbStorageVault` acted upon + to enter the given state(s). + + :param str exascale_db_storage_vault_id: (required) + The Exadata Database Storage Vault `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) + Request to update the attributes of a Exadata Database Storage Vault. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExascaleDbStorageVault.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` + + :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_exascale_db_storage_vault(exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + exascale_db_storage_vault_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_exadata_iorm_config(db_system_id), # noqa: F821 + self.client.get_exascale_db_storage_vault(exascale_db_storage_vault_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -12091,31 +13453,31 @@ def update_exadata_iorm_config_and_wait_for_state(self, db_system_id, exadata_io except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadb_vm_cluster_and_wait_for_work_request(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_execution_action_and_wait_for_work_request(self, execution_action_id, update_execution_action_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadb_vm_cluster` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_execution_action` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str execution_action_id: (required) + The execution action `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) - Request to update the attributes of a Exadata VM cluster on Exascale Infrastructure. + :param oci.database.models.UpdateExecutionActionDetails update_execution_action_details: (required) + Request to update the properties of a execution action. :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_exadb_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_execution_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.update_exadb_vm_cluster(exadb_vm_cluster_id, update_exadb_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_execution_action(execution_action_id, update_execution_action_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] if 'opc-work-request-id' not in operation_result.headers: @@ -12132,39 +13494,39 @@ def update_exadb_vm_cluster_and_wait_for_work_request(self, exadb_vm_cluster_id, except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exadb_vm_cluster_and_wait_for_state(self, exadb_vm_cluster_id, update_exadb_vm_cluster_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_execution_action_and_wait_for_state(self, execution_action_id, update_execution_action_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exadb_vm_cluster` and waits for the :py:class:`~oci.database.models.ExadbVmCluster` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_execution_action` and waits for the :py:class:`~oci.database.models.ExecutionAction` acted upon to enter the given state(s). - :param str exadb_vm_cluster_id: (required) - The Exadata VM cluster `OCID`__ on Exascale Infrastructure. + :param str execution_action_id: (required) + The execution action `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExadbVmClusterDetails update_exadb_vm_cluster_details: (required) - Request to update the attributes of a Exadata VM cluster on Exascale Infrastructure. + :param oci.database.models.UpdateExecutionActionDetails update_execution_action_details: (required) + Request to update the properties of a execution action. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExadbVmCluster.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionAction.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exadb_vm_cluster` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_execution_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.update_exadb_vm_cluster(exadb_vm_cluster_id, update_exadb_vm_cluster_details, **operation_kwargs) + operation_result = self.client.update_execution_action(execution_action_id, update_execution_action_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - exadb_vm_cluster_id = operation_result.data.id + execution_action_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_exadb_vm_cluster(exadb_vm_cluster_id), # noqa: F821 + self.client.get_execution_action(execution_action_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -12179,31 +13541,31 @@ def update_exadb_vm_cluster_and_wait_for_state(self, exadb_vm_cluster_id, update except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exascale_db_storage_vault_and_wait_for_work_request(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_execution_window_and_wait_for_work_request(self, execution_window_id, update_execution_window_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` and waits for the oci.work_requests.models.WorkRequest + Calls :py:func:`~oci.database.DatabaseClient.update_execution_window` and waits for the oci.work_requests.models.WorkRequest to enter the given state(s). - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `OCID`__. + :param str execution_window_id: (required) + The execution window `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) - Request to update the attributes of a Exadata Database Storage Vault. + :param oci.database.models.UpdateExecutionWindowDetails update_execution_window_details: (required) + Request to update the properties of a execution window. :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_exascale_db_storage_vault` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_execution_window` :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_exascale_db_storage_vault(exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, **operation_kwargs) + operation_result = self.client.update_execution_window(execution_window_id, update_execution_window_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] if 'opc-work-request-id' not in operation_result.headers: @@ -12220,39 +13582,39 @@ def update_exascale_db_storage_vault_and_wait_for_work_request(self, exascale_db except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) - def update_exascale_db_storage_vault_and_wait_for_state(self, exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + def update_execution_window_and_wait_for_state(self, execution_window_id, update_execution_window_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ - Calls :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` and waits for the :py:class:`~oci.database.models.ExascaleDbStorageVault` acted upon + Calls :py:func:`~oci.database.DatabaseClient.update_execution_window` and waits for the :py:class:`~oci.database.models.ExecutionWindow` acted upon to enter the given state(s). - :param str exascale_db_storage_vault_id: (required) - The Exadata Database Storage Vault `OCID`__. + :param str execution_window_id: (required) + The execution window `OCID`__. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - :param oci.database.models.UpdateExascaleDbStorageVaultDetails update_exascale_db_storage_vault_details: (required) - Request to update the attributes of a Exadata Database Storage Vault. + :param oci.database.models.UpdateExecutionWindowDetails update_execution_window_details: (required) + Request to update the properties of a execution window. :param list[str] wait_for_states: - An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExascaleDbStorageVault.lifecycle_state` + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ExecutionWindow.lifecycle_state` :param dict operation_kwargs: - A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_exascale_db_storage_vault` + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_execution_window` :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_exascale_db_storage_vault(exascale_db_storage_vault_id, update_exascale_db_storage_vault_details, **operation_kwargs) + operation_result = self.client.update_execution_window(execution_window_id, update_execution_window_details, **operation_kwargs) if not wait_for_states: return operation_result lowered_wait_for_states = [w.lower() for w in wait_for_states] - exascale_db_storage_vault_id = operation_result.data.id + execution_window_id = operation_result.data.id try: waiter_result = oci.wait_until( self.client, - self.client.get_exascale_db_storage_vault(exascale_db_storage_vault_id), # noqa: F821 + self.client.get_execution_window(execution_window_id), # noqa: F821 evaluate_response=lambda r: getattr(r.data, 'lifecycle_state') and getattr(r.data, 'lifecycle_state').lower() in lowered_wait_for_states, **waiter_kwargs ) @@ -12850,6 +14212,280 @@ def update_pluggable_database_and_wait_for_state(self, pluggable_database_id, up except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def update_scheduled_action_and_wait_for_work_request(self, scheduled_action_id, update_scheduled_action_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduled_action` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduled_action_id: (required) + The Scheduled Action `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateScheduledActionDetails update_scheduled_action_details: (required) + Request to update the properties of a Scheduled Action. + + :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_scheduled_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.update_scheduled_action(scheduled_action_id, update_scheduled_action_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 update_scheduled_action_and_wait_for_state(self, scheduled_action_id, update_scheduled_action_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduled_action` and waits for the :py:class:`~oci.database.models.ScheduledAction` acted upon + to enter the given state(s). + + :param str scheduled_action_id: (required) + The Scheduled Action `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateScheduledActionDetails update_scheduled_action_details: (required) + Request to update the properties of a Scheduled Action. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.ScheduledAction.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_scheduled_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.update_scheduled_action(scheduled_action_id, update_scheduled_action_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + scheduled_action_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_scheduled_action(scheduled_action_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_scheduling_policy_and_wait_for_work_request(self, scheduling_policy_id, update_scheduling_policy_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduling_policy` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateSchedulingPolicyDetails update_scheduling_policy_details: (required) + Request to update the properties of a Scheduling Policy. + + :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_scheduling_policy` + + :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_scheduling_policy(scheduling_policy_id, update_scheduling_policy_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 update_scheduling_policy_and_wait_for_state(self, scheduling_policy_id, update_scheduling_policy_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduling_policy` and waits for the :py:class:`~oci.database.models.SchedulingPolicy` acted upon + to enter the given state(s). + + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateSchedulingPolicyDetails update_scheduling_policy_details: (required) + Request to update the properties of a Scheduling Policy. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingPolicy.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_scheduling_policy` + + :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_scheduling_policy(scheduling_policy_id, update_scheduling_policy_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + scheduling_policy_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_scheduling_policy(scheduling_policy_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_scheduling_window_and_wait_for_work_request(self, scheduling_policy_id, scheduling_window_id, update_scheduling_window_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduling_window` and waits for the oci.work_requests.models.WorkRequest + to enter the given state(s). + + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str scheduling_window_id: (required) + The Scheduling Window `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateSchedulingWindowDetails update_scheduling_window_details: (required) + Request to update the properties of a Scheduling Window. + + :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_scheduling_window` + + :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_scheduling_window(scheduling_policy_id, scheduling_window_id, update_scheduling_window_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + 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 update_scheduling_window_and_wait_for_state(self, scheduling_policy_id, scheduling_window_id, update_scheduling_window_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database.DatabaseClient.update_scheduling_window` and waits for the :py:class:`~oci.database.models.SchedulingWindow` acted upon + to enter the given state(s). + + :param str scheduling_policy_id: (required) + The Scheduling Policy `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param str scheduling_window_id: (required) + The Scheduling Window `OCID`__. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database.models.UpdateSchedulingWindowDetails update_scheduling_window_details: (required) + Request to update the properties of a Scheduling Window. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.database.models.SchedulingWindow.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database.DatabaseClient.update_scheduling_window` + + :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_scheduling_window(scheduling_policy_id, scheduling_window_id, update_scheduling_window_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + scheduling_window_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_scheduling_window(scheduling_policy_id, scheduling_window_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def update_vm_cluster_and_wait_for_work_request(self, vm_cluster_id, update_vm_cluster_details, work_request_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database.DatabaseClient.update_vm_cluster` and waits for the oci.work_requests.models.WorkRequest diff --git a/src/oci/database/models/__init__.py b/src/oci/database/models/__init__.py index e77b1d6e6b..3ec4b3f622 100644 --- a/src/oci/database/models/__init__.py +++ b/src/oci/database/models/__init__.py @@ -7,6 +7,10 @@ from __future__ import absolute_import from .acd_avm_resource_stats import AcdAvmResourceStats +from .action_member import ActionMember +from .action_order_details import ActionOrderDetails +from .action_param_values_collection import ActionParamValuesCollection +from .action_param_values_summary import ActionParamValuesSummary from .activate_exadata_infrastructure_details import ActivateExadataInfrastructureDetails from .add_virtual_machine_to_cloud_vm_cluster_details import AddVirtualMachineToCloudVmClusterDetails from .add_virtual_machine_to_vm_cluster_details import AddVirtualMachineToVmClusterDetails @@ -64,6 +68,7 @@ from .backup_destination_details import BackupDestinationDetails from .backup_destination_summary import BackupDestinationSummary from .backup_summary import BackupSummary +from .cancel_execution_window_details import CancelExecutionWindowDetails from .change_autonomous_database_software_image_compartment_details import ChangeAutonomousDatabaseSoftwareImageCompartmentDetails from .change_autonomous_database_subscription_details import ChangeAutonomousDatabaseSubscriptionDetails from .change_autonomous_vm_cluster_compartment_details import ChangeAutonomousVmClusterCompartmentDetails @@ -80,6 +85,8 @@ from .change_exascale_db_storage_vault_compartment_details import ChangeExascaleDbStorageVaultCompartmentDetails from .change_key_store_compartment_details import ChangeKeyStoreCompartmentDetails from .change_key_store_type_details import ChangeKeyStoreTypeDetails +from .change_scheduling_plan_compartment_details import ChangeSchedulingPlanCompartmentDetails +from .change_scheduling_policy_compartment_details import ChangeSchedulingPolicyCompartmentDetails from .change_subscription_details import ChangeSubscriptionDetails from .change_vm_cluster_compartment_details import ChangeVmClusterCompartmentDetails from .cloud_automation_apply_update_time_preference import CloudAutomationApplyUpdateTimePreference @@ -153,6 +160,8 @@ from .create_exadata_infrastructure_details import CreateExadataInfrastructureDetails from .create_exadb_vm_cluster_details import CreateExadbVmClusterDetails from .create_exascale_db_storage_vault_details import CreateExascaleDbStorageVaultDetails +from .create_execution_action_details import CreateExecutionActionDetails +from .create_execution_window_details import CreateExecutionWindowDetails from .create_external_backup_job_details import CreateExternalBackupJobDetails from .create_external_container_database_details import CreateExternalContainerDatabaseDetails from .create_external_database_connector_details import CreateExternalDatabaseConnectorDetails @@ -173,6 +182,10 @@ from .create_pluggable_database_refreshable_clone_details import CreatePluggableDatabaseRefreshableCloneDetails from .create_recovery_appliance_backup_destination_details import CreateRecoveryApplianceBackupDestinationDetails from .create_refreshable_autonomous_database_clone_details import CreateRefreshableAutonomousDatabaseCloneDetails +from .create_scheduled_action_details import CreateScheduledActionDetails +from .create_scheduling_plan_details import CreateSchedulingPlanDetails +from .create_scheduling_policy_details import CreateSchedulingPolicyDetails +from .create_scheduling_window_details import CreateSchedulingWindowDetails from .create_vm_cluster_details import CreateVmClusterDetails from .customer_contact import CustomerContact from .data_collection_options import DataCollectionOptions @@ -261,6 +274,11 @@ from .exascale_db_storage_input_details import ExascaleDbStorageInputDetails from .exascale_db_storage_vault import ExascaleDbStorageVault from .exascale_db_storage_vault_summary import ExascaleDbStorageVaultSummary +from .execution_action import ExecutionAction +from .execution_action_member import ExecutionActionMember +from .execution_action_summary import ExecutionActionSummary +from .execution_window import ExecutionWindow +from .execution_window_summary import ExecutionWindowSummary from .external_backup_job import ExternalBackupJob from .external_container_database import ExternalContainerDatabase from .external_container_database_summary import ExternalContainerDatabaseSummary @@ -281,6 +299,7 @@ from .generate_recommended_network_details import GenerateRecommendedNetworkDetails from .gi_minor_version_summary import GiMinorVersionSummary from .gi_version_summary import GiVersionSummary +from .granular_maintenance_history_details import GranularMaintenanceHistoryDetails from .info_for_network_gen_details import InfoForNetworkGenDetails from .infrastructure_target_version import InfrastructureTargetVersion from .infrastructure_target_version_summary import InfrastructureTargetVersionSummary @@ -307,6 +326,7 @@ from .modify_pluggable_database_management_details import ModifyPluggableDatabaseManagementDetails from .month import Month from .mount_type_details import MountTypeDetails +from .move_execution_action_member_details import MoveExecutionActionMemberDetails from .network_bonding_mode_details import NetworkBondingModeDetails from .node_details import NodeDetails from .ocp_us import OCPUs @@ -328,6 +348,8 @@ from .pluggable_database_node_level_details import PluggableDatabaseNodeLevelDetails from .pluggable_database_refreshable_clone_config import PluggableDatabaseRefreshableCloneConfig from .pluggable_database_summary import PluggableDatabaseSummary +from .recommended_scheduled_action_summary import RecommendedScheduledActionSummary +from .recommended_scheduled_actions_collection import RecommendedScheduledActionsCollection from .refreshable_clone_collection import RefreshableCloneCollection from .refreshable_clone_summary import RefreshableCloneSummary from .register_autonomous_database_data_safe_details import RegisterAutonomousDatabaseDataSafeDetails @@ -336,6 +358,8 @@ from .remove_virtual_machine_from_cloud_vm_cluster_details import RemoveVirtualMachineFromCloudVmClusterDetails from .remove_virtual_machine_from_exadb_vm_cluster_details import RemoveVirtualMachineFromExadbVmClusterDetails from .remove_virtual_machine_from_vm_cluster_details import RemoveVirtualMachineFromVmClusterDetails +from .reorder_execution_action_details import ReorderExecutionActionDetails +from .reorder_scheduled_actions_details import ReorderScheduledActionsDetails from .resize_vm_cluster_network_details import ResizeVmClusterNetworkDetails from .resource_pool_shape_collection import ResourcePoolShapeCollection from .resource_pool_shape_summary import ResourcePoolShapeSummary @@ -349,7 +373,17 @@ from .saas_admin_user_configuration import SaasAdminUserConfiguration from .saas_admin_user_status import SaasAdminUserStatus from .scan_details import ScanDetails +from .scheduled_action import ScheduledAction +from .scheduled_action_collection import ScheduledActionCollection +from .scheduled_action_summary import ScheduledActionSummary from .scheduled_operation_details import ScheduledOperationDetails +from .scheduling_plan import SchedulingPlan +from .scheduling_plan_collection import SchedulingPlanCollection +from .scheduling_plan_summary import SchedulingPlanSummary +from .scheduling_policy import SchedulingPolicy +from .scheduling_policy_summary import SchedulingPolicySummary +from .scheduling_window import SchedulingWindow +from .scheduling_window_summary import SchedulingWindowSummary from .self_mount_details import SelfMountDetails from .stack_monitoring_config import StackMonitoringConfig from .storage_performance_details import StoragePerformanceDetails @@ -381,6 +415,8 @@ from .update_exadata_infrastructure_details import UpdateExadataInfrastructureDetails from .update_exadb_vm_cluster_details import UpdateExadbVmClusterDetails from .update_exascale_db_storage_vault_details import UpdateExascaleDbStorageVaultDetails +from .update_execution_action_details import UpdateExecutionActionDetails +from .update_execution_window_details import UpdateExecutionWindowDetails from .update_external_container_database_details import UpdateExternalContainerDatabaseDetails from .update_external_database_connector_details import UpdateExternalDatabaseConnectorDetails from .update_external_database_details_base import UpdateExternalDatabaseDetailsBase @@ -393,6 +429,9 @@ from .update_maintenance_run_details import UpdateMaintenanceRunDetails from .update_oneoff_patch_details import UpdateOneoffPatchDetails from .update_pluggable_database_details import UpdatePluggableDatabaseDetails +from .update_scheduled_action_details import UpdateScheduledActionDetails +from .update_scheduling_policy_details import UpdateSchedulingPolicyDetails +from .update_scheduling_window_details import UpdateSchedulingWindowDetails from .update_summary import UpdateSummary from .update_vm_cluster_details import UpdateVmClusterDetails from .update_vm_cluster_network_details import UpdateVmClusterNetworkDetails @@ -409,11 +448,16 @@ from .vm_cluster_update_history_entry_summary import VmClusterUpdateHistoryEntrySummary from .vm_cluster_update_summary import VmClusterUpdateSummary from .vm_network_details import VmNetworkDetails +from .window_preference_detail import WindowPreferenceDetail from .workload_type import WorkloadType # Maps type names to classes for database services. database_type_mapping = { "AcdAvmResourceStats": AcdAvmResourceStats, + "ActionMember": ActionMember, + "ActionOrderDetails": ActionOrderDetails, + "ActionParamValuesCollection": ActionParamValuesCollection, + "ActionParamValuesSummary": ActionParamValuesSummary, "ActivateExadataInfrastructureDetails": ActivateExadataInfrastructureDetails, "AddVirtualMachineToCloudVmClusterDetails": AddVirtualMachineToCloudVmClusterDetails, "AddVirtualMachineToVmClusterDetails": AddVirtualMachineToVmClusterDetails, @@ -471,6 +515,7 @@ "BackupDestinationDetails": BackupDestinationDetails, "BackupDestinationSummary": BackupDestinationSummary, "BackupSummary": BackupSummary, + "CancelExecutionWindowDetails": CancelExecutionWindowDetails, "ChangeAutonomousDatabaseSoftwareImageCompartmentDetails": ChangeAutonomousDatabaseSoftwareImageCompartmentDetails, "ChangeAutonomousDatabaseSubscriptionDetails": ChangeAutonomousDatabaseSubscriptionDetails, "ChangeAutonomousVmClusterCompartmentDetails": ChangeAutonomousVmClusterCompartmentDetails, @@ -487,6 +532,8 @@ "ChangeExascaleDbStorageVaultCompartmentDetails": ChangeExascaleDbStorageVaultCompartmentDetails, "ChangeKeyStoreCompartmentDetails": ChangeKeyStoreCompartmentDetails, "ChangeKeyStoreTypeDetails": ChangeKeyStoreTypeDetails, + "ChangeSchedulingPlanCompartmentDetails": ChangeSchedulingPlanCompartmentDetails, + "ChangeSchedulingPolicyCompartmentDetails": ChangeSchedulingPolicyCompartmentDetails, "ChangeSubscriptionDetails": ChangeSubscriptionDetails, "ChangeVmClusterCompartmentDetails": ChangeVmClusterCompartmentDetails, "CloudAutomationApplyUpdateTimePreference": CloudAutomationApplyUpdateTimePreference, @@ -560,6 +607,8 @@ "CreateExadataInfrastructureDetails": CreateExadataInfrastructureDetails, "CreateExadbVmClusterDetails": CreateExadbVmClusterDetails, "CreateExascaleDbStorageVaultDetails": CreateExascaleDbStorageVaultDetails, + "CreateExecutionActionDetails": CreateExecutionActionDetails, + "CreateExecutionWindowDetails": CreateExecutionWindowDetails, "CreateExternalBackupJobDetails": CreateExternalBackupJobDetails, "CreateExternalContainerDatabaseDetails": CreateExternalContainerDatabaseDetails, "CreateExternalDatabaseConnectorDetails": CreateExternalDatabaseConnectorDetails, @@ -580,6 +629,10 @@ "CreatePluggableDatabaseRefreshableCloneDetails": CreatePluggableDatabaseRefreshableCloneDetails, "CreateRecoveryApplianceBackupDestinationDetails": CreateRecoveryApplianceBackupDestinationDetails, "CreateRefreshableAutonomousDatabaseCloneDetails": CreateRefreshableAutonomousDatabaseCloneDetails, + "CreateScheduledActionDetails": CreateScheduledActionDetails, + "CreateSchedulingPlanDetails": CreateSchedulingPlanDetails, + "CreateSchedulingPolicyDetails": CreateSchedulingPolicyDetails, + "CreateSchedulingWindowDetails": CreateSchedulingWindowDetails, "CreateVmClusterDetails": CreateVmClusterDetails, "CustomerContact": CustomerContact, "DataCollectionOptions": DataCollectionOptions, @@ -668,6 +721,11 @@ "ExascaleDbStorageInputDetails": ExascaleDbStorageInputDetails, "ExascaleDbStorageVault": ExascaleDbStorageVault, "ExascaleDbStorageVaultSummary": ExascaleDbStorageVaultSummary, + "ExecutionAction": ExecutionAction, + "ExecutionActionMember": ExecutionActionMember, + "ExecutionActionSummary": ExecutionActionSummary, + "ExecutionWindow": ExecutionWindow, + "ExecutionWindowSummary": ExecutionWindowSummary, "ExternalBackupJob": ExternalBackupJob, "ExternalContainerDatabase": ExternalContainerDatabase, "ExternalContainerDatabaseSummary": ExternalContainerDatabaseSummary, @@ -688,6 +746,7 @@ "GenerateRecommendedNetworkDetails": GenerateRecommendedNetworkDetails, "GiMinorVersionSummary": GiMinorVersionSummary, "GiVersionSummary": GiVersionSummary, + "GranularMaintenanceHistoryDetails": GranularMaintenanceHistoryDetails, "InfoForNetworkGenDetails": InfoForNetworkGenDetails, "InfrastructureTargetVersion": InfrastructureTargetVersion, "InfrastructureTargetVersionSummary": InfrastructureTargetVersionSummary, @@ -714,6 +773,7 @@ "ModifyPluggableDatabaseManagementDetails": ModifyPluggableDatabaseManagementDetails, "Month": Month, "MountTypeDetails": MountTypeDetails, + "MoveExecutionActionMemberDetails": MoveExecutionActionMemberDetails, "NetworkBondingModeDetails": NetworkBondingModeDetails, "NodeDetails": NodeDetails, "OCPUs": OCPUs, @@ -735,6 +795,8 @@ "PluggableDatabaseNodeLevelDetails": PluggableDatabaseNodeLevelDetails, "PluggableDatabaseRefreshableCloneConfig": PluggableDatabaseRefreshableCloneConfig, "PluggableDatabaseSummary": PluggableDatabaseSummary, + "RecommendedScheduledActionSummary": RecommendedScheduledActionSummary, + "RecommendedScheduledActionsCollection": RecommendedScheduledActionsCollection, "RefreshableCloneCollection": RefreshableCloneCollection, "RefreshableCloneSummary": RefreshableCloneSummary, "RegisterAutonomousDatabaseDataSafeDetails": RegisterAutonomousDatabaseDataSafeDetails, @@ -743,6 +805,8 @@ "RemoveVirtualMachineFromCloudVmClusterDetails": RemoveVirtualMachineFromCloudVmClusterDetails, "RemoveVirtualMachineFromExadbVmClusterDetails": RemoveVirtualMachineFromExadbVmClusterDetails, "RemoveVirtualMachineFromVmClusterDetails": RemoveVirtualMachineFromVmClusterDetails, + "ReorderExecutionActionDetails": ReorderExecutionActionDetails, + "ReorderScheduledActionsDetails": ReorderScheduledActionsDetails, "ResizeVmClusterNetworkDetails": ResizeVmClusterNetworkDetails, "ResourcePoolShapeCollection": ResourcePoolShapeCollection, "ResourcePoolShapeSummary": ResourcePoolShapeSummary, @@ -756,7 +820,17 @@ "SaasAdminUserConfiguration": SaasAdminUserConfiguration, "SaasAdminUserStatus": SaasAdminUserStatus, "ScanDetails": ScanDetails, + "ScheduledAction": ScheduledAction, + "ScheduledActionCollection": ScheduledActionCollection, + "ScheduledActionSummary": ScheduledActionSummary, "ScheduledOperationDetails": ScheduledOperationDetails, + "SchedulingPlan": SchedulingPlan, + "SchedulingPlanCollection": SchedulingPlanCollection, + "SchedulingPlanSummary": SchedulingPlanSummary, + "SchedulingPolicy": SchedulingPolicy, + "SchedulingPolicySummary": SchedulingPolicySummary, + "SchedulingWindow": SchedulingWindow, + "SchedulingWindowSummary": SchedulingWindowSummary, "SelfMountDetails": SelfMountDetails, "StackMonitoringConfig": StackMonitoringConfig, "StoragePerformanceDetails": StoragePerformanceDetails, @@ -788,6 +862,8 @@ "UpdateExadataInfrastructureDetails": UpdateExadataInfrastructureDetails, "UpdateExadbVmClusterDetails": UpdateExadbVmClusterDetails, "UpdateExascaleDbStorageVaultDetails": UpdateExascaleDbStorageVaultDetails, + "UpdateExecutionActionDetails": UpdateExecutionActionDetails, + "UpdateExecutionWindowDetails": UpdateExecutionWindowDetails, "UpdateExternalContainerDatabaseDetails": UpdateExternalContainerDatabaseDetails, "UpdateExternalDatabaseConnectorDetails": UpdateExternalDatabaseConnectorDetails, "UpdateExternalDatabaseDetailsBase": UpdateExternalDatabaseDetailsBase, @@ -800,6 +876,9 @@ "UpdateMaintenanceRunDetails": UpdateMaintenanceRunDetails, "UpdateOneoffPatchDetails": UpdateOneoffPatchDetails, "UpdatePluggableDatabaseDetails": UpdatePluggableDatabaseDetails, + "UpdateScheduledActionDetails": UpdateScheduledActionDetails, + "UpdateSchedulingPolicyDetails": UpdateSchedulingPolicyDetails, + "UpdateSchedulingWindowDetails": UpdateSchedulingWindowDetails, "UpdateSummary": UpdateSummary, "UpdateVmClusterDetails": UpdateVmClusterDetails, "UpdateVmClusterNetworkDetails": UpdateVmClusterNetworkDetails, @@ -816,5 +895,6 @@ "VmClusterUpdateHistoryEntrySummary": VmClusterUpdateHistoryEntrySummary, "VmClusterUpdateSummary": VmClusterUpdateSummary, "VmNetworkDetails": VmNetworkDetails, + "WindowPreferenceDetail": WindowPreferenceDetail, "WorkloadType": WorkloadType } diff --git a/src/oci/database/models/action_member.py b/src/oci/database/models/action_member.py new file mode 100644 index 0000000000..6138398ff2 --- /dev/null +++ b/src/oci/database/models/action_member.py @@ -0,0 +1,134 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ActionMember(object): + """ + The details of an action member. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ActionMember object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param member_order: + The value to assign to the member_order property of this ActionMember. + :type member_order: int + + :param member_id: + The value to assign to the member_id property of this ActionMember. + :type member_id: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ActionMember. + :type estimated_time_in_mins: int + + """ + self.swagger_types = { + 'member_order': 'int', + 'member_id': 'str', + 'estimated_time_in_mins': 'int' + } + + self.attribute_map = { + 'member_order': 'memberOrder', + 'member_id': 'memberId', + 'estimated_time_in_mins': 'estimatedTimeInMins' + } + + self._member_order = None + self._member_id = None + self._estimated_time_in_mins = None + + @property + def member_order(self): + """ + **[Required]** Gets the member_order of this ActionMember. + The order of the action member in a scheduled action. + + + :return: The member_order of this ActionMember. + :rtype: int + """ + return self._member_order + + @member_order.setter + def member_order(self, member_order): + """ + Sets the member_order of this ActionMember. + The order of the action member in a scheduled action. + + + :param member_order: The member_order of this ActionMember. + :type: int + """ + self._member_order = member_order + + @property + def member_id(self): + """ + **[Required]** Gets the member_id of this ActionMember. + The ocid of the action member. + + + :return: The member_id of this ActionMember. + :rtype: str + """ + return self._member_id + + @member_id.setter + def member_id(self, member_id): + """ + Sets the member_id of this ActionMember. + The ocid of the action member. + + + :param member_id: The member_id of this ActionMember. + :type: str + """ + self._member_id = member_id + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ActionMember. + The estimated time for the intended action member. + + + :return: The estimated_time_in_mins of this ActionMember. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ActionMember. + The estimated time for the intended action member. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ActionMember. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + 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/action_order_details.py b/src/oci/database/models/action_order_details.py new file mode 100644 index 0000000000..434a0555b4 --- /dev/null +++ b/src/oci/database/models/action_order_details.py @@ -0,0 +1,107 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ActionOrderDetails(object): + """ + Describes the ordering list of action resources. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ActionOrderDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param action_order: + The value to assign to the action_order property of this ActionOrderDetails. + :type action_order: int + + :param action_resource_id: + The value to assign to the action_resource_id property of this ActionOrderDetails. + :type action_resource_id: str + + """ + self.swagger_types = { + 'action_order': 'int', + 'action_resource_id': 'str' + } + + self.attribute_map = { + 'action_order': 'actionOrder', + 'action_resource_id': 'actionResourceId' + } + + self._action_order = None + self._action_resource_id = None + + @property + def action_order(self): + """ + Gets the action_order of this ActionOrderDetails. + The priority order of the action resource. + + + :return: The action_order of this ActionOrderDetails. + :rtype: int + """ + return self._action_order + + @action_order.setter + def action_order(self, action_order): + """ + Sets the action_order of this ActionOrderDetails. + The priority order of the action resource. + + + :param action_order: The action_order of this ActionOrderDetails. + :type: int + """ + self._action_order = action_order + + @property + def action_resource_id(self): + """ + Gets the action_resource_id of this ActionOrderDetails. + The `OCID`__ of the action resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The action_resource_id of this ActionOrderDetails. + :rtype: str + """ + return self._action_resource_id + + @action_resource_id.setter + def action_resource_id(self, action_resource_id): + """ + Sets the action_resource_id of this ActionOrderDetails. + The `OCID`__ of the action resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param action_resource_id: The action_resource_id of this ActionOrderDetails. + :type: str + """ + self._action_resource_id = action_resource_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/action_param_values_collection.py b/src/oci/database/models/action_param_values_collection.py new file mode 100644 index 0000000000..347b245214 --- /dev/null +++ b/src/oci/database/models/action_param_values_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ActionParamValuesCollection(object): + """ + A list of Action Parameters. Contains ActionParamValues items. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ActionParamValuesCollection 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 ActionParamValuesCollection. + :type items: list[oci.database.models.ActionParamValuesSummary] + + """ + self.swagger_types = { + 'items': 'list[ActionParamValuesSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ActionParamValuesCollection. + List of Action Parameters and their possible values. + + + :return: The items of this ActionParamValuesCollection. + :rtype: list[oci.database.models.ActionParamValuesSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ActionParamValuesCollection. + List of Action Parameters and their possible values. + + + :param items: The items of this ActionParamValuesCollection. + :type: list[oci.database.models.ActionParamValuesSummary] + """ + 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/database/models/action_param_values_summary.py b/src/oci/database/models/action_param_values_summary.py new file mode 100644 index 0000000000..daf5081a6e --- /dev/null +++ b/src/oci/database/models/action_param_values_summary.py @@ -0,0 +1,216 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ActionParamValuesSummary(object): + """ + Details of the action parameter and its possible values that is used in listParamsForActionType. + """ + + #: A constant which can be used with the parameter_type property of a ActionParamValuesSummary. + #: This constant has a value of "BOOLEAN" + PARAMETER_TYPE_BOOLEAN = "BOOLEAN" + + #: A constant which can be used with the parameter_type property of a ActionParamValuesSummary. + #: This constant has a value of "STRING" + PARAMETER_TYPE_STRING = "STRING" + + #: A constant which can be used with the parameter_type property of a ActionParamValuesSummary. + #: This constant has a value of "INTEGER" + PARAMETER_TYPE_INTEGER = "INTEGER" + + def __init__(self, **kwargs): + """ + Initializes a new ActionParamValuesSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param parameter_name: + The value to assign to the parameter_name property of this ActionParamValuesSummary. + :type parameter_name: str + + :param parameter_type: + The value to assign to the parameter_type property of this ActionParamValuesSummary. + Allowed values for this property are: "BOOLEAN", "STRING", "INTEGER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type parameter_type: str + + :param parameter_values: + The value to assign to the parameter_values property of this ActionParamValuesSummary. + :type parameter_values: list[str] + + :param default_value: + The value to assign to the default_value property of this ActionParamValuesSummary. + :type default_value: str + + :param is_required: + The value to assign to the is_required property of this ActionParamValuesSummary. + :type is_required: bool + + """ + self.swagger_types = { + 'parameter_name': 'str', + 'parameter_type': 'str', + 'parameter_values': 'list[str]', + 'default_value': 'str', + 'is_required': 'bool' + } + + self.attribute_map = { + 'parameter_name': 'parameterName', + 'parameter_type': 'parameterType', + 'parameter_values': 'parameterValues', + 'default_value': 'defaultValue', + 'is_required': 'isRequired' + } + + self._parameter_name = None + self._parameter_type = None + self._parameter_values = None + self._default_value = None + self._is_required = None + + @property + def parameter_name(self): + """ + **[Required]** Gets the parameter_name of this ActionParamValuesSummary. + The name of this parameter. + + + :return: The parameter_name of this ActionParamValuesSummary. + :rtype: str + """ + return self._parameter_name + + @parameter_name.setter + def parameter_name(self, parameter_name): + """ + Sets the parameter_name of this ActionParamValuesSummary. + The name of this parameter. + + + :param parameter_name: The parameter_name of this ActionParamValuesSummary. + :type: str + """ + self._parameter_name = parameter_name + + @property + def parameter_type(self): + """ + **[Required]** Gets the parameter_type of this ActionParamValuesSummary. + The type of the parameter. + + Allowed values for this property are: "BOOLEAN", "STRING", "INTEGER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The parameter_type of this ActionParamValuesSummary. + :rtype: str + """ + return self._parameter_type + + @parameter_type.setter + def parameter_type(self, parameter_type): + """ + Sets the parameter_type of this ActionParamValuesSummary. + The type of the parameter. + + + :param parameter_type: The parameter_type of this ActionParamValuesSummary. + :type: str + """ + allowed_values = ["BOOLEAN", "STRING", "INTEGER"] + if not value_allowed_none_or_none_sentinel(parameter_type, allowed_values): + parameter_type = 'UNKNOWN_ENUM_VALUE' + self._parameter_type = parameter_type + + @property + def parameter_values(self): + """ + **[Required]** Gets the parameter_values of this ActionParamValuesSummary. + Possible values for this parameter. In case of integer it's min and max values. + + + :return: The parameter_values of this ActionParamValuesSummary. + :rtype: list[str] + """ + return self._parameter_values + + @parameter_values.setter + def parameter_values(self, parameter_values): + """ + Sets the parameter_values of this ActionParamValuesSummary. + Possible values for this parameter. In case of integer it's min and max values. + + + :param parameter_values: The parameter_values of this ActionParamValuesSummary. + :type: list[str] + """ + self._parameter_values = parameter_values + + @property + def default_value(self): + """ + Gets the default_value of this ActionParamValuesSummary. + The default value for this parameter. + + + :return: The default_value of this ActionParamValuesSummary. + :rtype: str + """ + return self._default_value + + @default_value.setter + def default_value(self, default_value): + """ + Sets the default_value of this ActionParamValuesSummary. + The default value for this parameter. + + + :param default_value: The default_value of this ActionParamValuesSummary. + :type: str + """ + self._default_value = default_value + + @property + def is_required(self): + """ + **[Required]** Gets the is_required of this ActionParamValuesSummary. + Whether this parameter is required or not for this action type.\u3001 + + + :return: The is_required of this ActionParamValuesSummary. + :rtype: bool + """ + return self._is_required + + @is_required.setter + def is_required(self, is_required): + """ + Sets the is_required of this ActionParamValuesSummary. + Whether this parameter is required or not for this action type.\u3001 + + + :param is_required: The is_required of this ActionParamValuesSummary. + :type: bool + """ + self._is_required = is_required + + 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/autonomous_database.py b/src/oci/database/models/autonomous_database.py index cec3cb22b5..ab590cb617 100644 --- a/src/oci/database/models/autonomous_database.py +++ b/src/oci/database/models/autonomous_database.py @@ -808,6 +808,10 @@ def __init__(self, **kwargs): Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type net_services_architecture: str + :param availability_domain: + The value to assign to the availability_domain property of this AutonomousDatabase. + :type availability_domain: str + :param cluster_placement_group_id: The value to assign to the cluster_placement_group_id property of this AutonomousDatabase. :type cluster_placement_group_id: str @@ -931,6 +935,7 @@ def __init__(self, **kwargs): 'time_disaster_recovery_role_changed': 'datetime', 'remote_disaster_recovery_configuration': 'DisasterRecoveryConfiguration', 'net_services_architecture': 'str', + 'availability_domain': 'str', 'cluster_placement_group_id': 'str' } @@ -1052,6 +1057,7 @@ def __init__(self, **kwargs): 'time_disaster_recovery_role_changed': 'timeDisasterRecoveryRoleChanged', 'remote_disaster_recovery_configuration': 'remoteDisasterRecoveryConfiguration', 'net_services_architecture': 'netServicesArchitecture', + 'availability_domain': 'availabilityDomain', 'cluster_placement_group_id': 'clusterPlacementGroupId' } @@ -1172,6 +1178,7 @@ def __init__(self, **kwargs): self._time_disaster_recovery_role_changed = None self._remote_disaster_recovery_configuration = None self._net_services_architecture = None + self._availability_domain = None self._cluster_placement_group_id = None @property @@ -2738,9 +2745,7 @@ def db_workload(self, db_workload): def is_dev_tier(self): """ Gets the is_dev_tier of this AutonomousDatabase. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :return: The is_dev_tier of this AutonomousDatabase. @@ -2752,9 +2757,7 @@ def is_dev_tier(self): def is_dev_tier(self, is_dev_tier): """ Sets the is_dev_tier of this AutonomousDatabase. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :param is_dev_tier: The is_dev_tier of this AutonomousDatabase. @@ -4382,6 +4385,30 @@ def net_services_architecture(self, net_services_architecture): net_services_architecture = 'UNKNOWN_ENUM_VALUE' self._net_services_architecture = net_services_architecture + @property + def availability_domain(self): + """ + Gets the availability_domain of this AutonomousDatabase. + The availability domain where the Autonomous Database Serverless instance is located. + + + :return: The availability_domain of this AutonomousDatabase. + :rtype: str + """ + return self._availability_domain + + @availability_domain.setter + def availability_domain(self, availability_domain): + """ + Sets the availability_domain of this AutonomousDatabase. + The availability domain where the Autonomous Database Serverless instance is located. + + + :param availability_domain: The availability_domain of this AutonomousDatabase. + :type: str + """ + self._availability_domain = availability_domain + @property def cluster_placement_group_id(self): """ diff --git a/src/oci/database/models/autonomous_database_standby_summary.py b/src/oci/database/models/autonomous_database_standby_summary.py index e570e73b07..6aaec9ecfe 100644 --- a/src/oci/database/models/autonomous_database_standby_summary.py +++ b/src/oci/database/models/autonomous_database_standby_summary.py @@ -126,13 +126,18 @@ def __init__(self, **kwargs): The value to assign to the time_disaster_recovery_role_changed property of this AutonomousDatabaseStandbySummary. :type time_disaster_recovery_role_changed: datetime + :param availability_domain: + The value to assign to the availability_domain property of this AutonomousDatabaseStandbySummary. + :type availability_domain: str + """ self.swagger_types = { 'lag_time_in_seconds': 'int', 'lifecycle_state': 'str', 'lifecycle_details': 'str', 'time_data_guard_role_changed': 'datetime', - 'time_disaster_recovery_role_changed': 'datetime' + 'time_disaster_recovery_role_changed': 'datetime', + 'availability_domain': 'str' } self.attribute_map = { @@ -140,7 +145,8 @@ def __init__(self, **kwargs): 'lifecycle_state': 'lifecycleState', 'lifecycle_details': 'lifecycleDetails', 'time_data_guard_role_changed': 'timeDataGuardRoleChanged', - 'time_disaster_recovery_role_changed': 'timeDisasterRecoveryRoleChanged' + 'time_disaster_recovery_role_changed': 'timeDisasterRecoveryRoleChanged', + 'availability_domain': 'availabilityDomain' } self._lag_time_in_seconds = None @@ -148,6 +154,7 @@ def __init__(self, **kwargs): self._lifecycle_details = None self._time_data_guard_role_changed = None self._time_disaster_recovery_role_changed = None + self._availability_domain = None @property def lag_time_in_seconds(self): @@ -275,6 +282,30 @@ def time_disaster_recovery_role_changed(self, time_disaster_recovery_role_change """ self._time_disaster_recovery_role_changed = time_disaster_recovery_role_changed + @property + def availability_domain(self): + """ + Gets the availability_domain of this AutonomousDatabaseStandbySummary. + The availability domain of a local Autonomous Data Guard standby database of an Autonomous Database Serverless instance. + + + :return: The availability_domain of this AutonomousDatabaseStandbySummary. + :rtype: str + """ + return self._availability_domain + + @availability_domain.setter + def availability_domain(self, availability_domain): + """ + Sets the availability_domain of this AutonomousDatabaseStandbySummary. + The availability domain of a local Autonomous Data Guard standby database of an Autonomous Database Serverless instance. + + + :param availability_domain: The availability_domain of this AutonomousDatabaseStandbySummary. + :type: str + """ + self._availability_domain = availability_domain + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/autonomous_database_summary.py b/src/oci/database/models/autonomous_database_summary.py index c27ca939ab..1cc4a89862 100644 --- a/src/oci/database/models/autonomous_database_summary.py +++ b/src/oci/database/models/autonomous_database_summary.py @@ -810,6 +810,10 @@ def __init__(self, **kwargs): Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type net_services_architecture: str + :param availability_domain: + The value to assign to the availability_domain property of this AutonomousDatabaseSummary. + :type availability_domain: str + :param cluster_placement_group_id: The value to assign to the cluster_placement_group_id property of this AutonomousDatabaseSummary. :type cluster_placement_group_id: str @@ -933,6 +937,7 @@ def __init__(self, **kwargs): 'time_disaster_recovery_role_changed': 'datetime', 'remote_disaster_recovery_configuration': 'DisasterRecoveryConfiguration', 'net_services_architecture': 'str', + 'availability_domain': 'str', 'cluster_placement_group_id': 'str' } @@ -1054,6 +1059,7 @@ def __init__(self, **kwargs): 'time_disaster_recovery_role_changed': 'timeDisasterRecoveryRoleChanged', 'remote_disaster_recovery_configuration': 'remoteDisasterRecoveryConfiguration', 'net_services_architecture': 'netServicesArchitecture', + 'availability_domain': 'availabilityDomain', 'cluster_placement_group_id': 'clusterPlacementGroupId' } @@ -1174,6 +1180,7 @@ def __init__(self, **kwargs): self._time_disaster_recovery_role_changed = None self._remote_disaster_recovery_configuration = None self._net_services_architecture = None + self._availability_domain = None self._cluster_placement_group_id = None @property @@ -2740,9 +2747,7 @@ def db_workload(self, db_workload): def is_dev_tier(self): """ Gets the is_dev_tier of this AutonomousDatabaseSummary. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :return: The is_dev_tier of this AutonomousDatabaseSummary. @@ -2754,9 +2759,7 @@ def is_dev_tier(self): def is_dev_tier(self, is_dev_tier): """ Sets the is_dev_tier of this AutonomousDatabaseSummary. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :param is_dev_tier: The is_dev_tier of this AutonomousDatabaseSummary. @@ -4384,6 +4387,30 @@ def net_services_architecture(self, net_services_architecture): net_services_architecture = 'UNKNOWN_ENUM_VALUE' self._net_services_architecture = net_services_architecture + @property + def availability_domain(self): + """ + Gets the availability_domain of this AutonomousDatabaseSummary. + The availability domain where the Autonomous Database Serverless instance is located. + + + :return: The availability_domain of this AutonomousDatabaseSummary. + :rtype: str + """ + return self._availability_domain + + @availability_domain.setter + def availability_domain(self, availability_domain): + """ + Sets the availability_domain of this AutonomousDatabaseSummary. + The availability domain where the Autonomous Database Serverless instance is located. + + + :param availability_domain: The availability_domain of this AutonomousDatabaseSummary. + :type: str + """ + self._availability_domain = availability_domain + @property def cluster_placement_group_id(self): """ diff --git a/src/oci/database/models/cancel_execution_window_details.py b/src/oci/database/models/cancel_execution_window_details.py new file mode 100644 index 0000000000..38a8a4d5ae --- /dev/null +++ b/src/oci/database/models/cancel_execution_window_details.py @@ -0,0 +1,134 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CancelExecutionWindowDetails(object): + """ + Describe the parameters to create a new execution window after this execution window is canceled. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CancelExecutionWindowDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param time_scheduled_of_new_window: + The value to assign to the time_scheduled_of_new_window property of this CancelExecutionWindowDetails. + :type time_scheduled_of_new_window: datetime + + :param window_duration_in_mins_of_new_window: + The value to assign to the window_duration_in_mins_of_new_window property of this CancelExecutionWindowDetails. + :type window_duration_in_mins_of_new_window: int + + :param is_enforced_duration_of_new_window: + The value to assign to the is_enforced_duration_of_new_window property of this CancelExecutionWindowDetails. + :type is_enforced_duration_of_new_window: bool + + """ + self.swagger_types = { + 'time_scheduled_of_new_window': 'datetime', + 'window_duration_in_mins_of_new_window': 'int', + 'is_enforced_duration_of_new_window': 'bool' + } + + self.attribute_map = { + 'time_scheduled_of_new_window': 'timeScheduledOfNewWindow', + 'window_duration_in_mins_of_new_window': 'windowDurationInMinsOfNewWindow', + 'is_enforced_duration_of_new_window': 'isEnforcedDurationOfNewWindow' + } + + self._time_scheduled_of_new_window = None + self._window_duration_in_mins_of_new_window = None + self._is_enforced_duration_of_new_window = None + + @property + def time_scheduled_of_new_window(self): + """ + **[Required]** Gets the time_scheduled_of_new_window of this CancelExecutionWindowDetails. + New scheduled date and time of the execution window. + + + :return: The time_scheduled_of_new_window of this CancelExecutionWindowDetails. + :rtype: datetime + """ + return self._time_scheduled_of_new_window + + @time_scheduled_of_new_window.setter + def time_scheduled_of_new_window(self, time_scheduled_of_new_window): + """ + Sets the time_scheduled_of_new_window of this CancelExecutionWindowDetails. + New scheduled date and time of the execution window. + + + :param time_scheduled_of_new_window: The time_scheduled_of_new_window of this CancelExecutionWindowDetails. + :type: datetime + """ + self._time_scheduled_of_new_window = time_scheduled_of_new_window + + @property + def window_duration_in_mins_of_new_window(self): + """ + **[Required]** Gets the window_duration_in_mins_of_new_window of this CancelExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The window_duration_in_mins_of_new_window of this CancelExecutionWindowDetails. + :rtype: int + """ + return self._window_duration_in_mins_of_new_window + + @window_duration_in_mins_of_new_window.setter + def window_duration_in_mins_of_new_window(self, window_duration_in_mins_of_new_window): + """ + Sets the window_duration_in_mins_of_new_window of this CancelExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param window_duration_in_mins_of_new_window: The window_duration_in_mins_of_new_window of this CancelExecutionWindowDetails. + :type: int + """ + self._window_duration_in_mins_of_new_window = window_duration_in_mins_of_new_window + + @property + def is_enforced_duration_of_new_window(self): + """ + Gets the is_enforced_duration_of_new_window of this CancelExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration_of_new_window of this CancelExecutionWindowDetails. + :rtype: bool + """ + return self._is_enforced_duration_of_new_window + + @is_enforced_duration_of_new_window.setter + def is_enforced_duration_of_new_window(self, is_enforced_duration_of_new_window): + """ + Sets the is_enforced_duration_of_new_window of this CancelExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration_of_new_window: The is_enforced_duration_of_new_window of this CancelExecutionWindowDetails. + :type: bool + """ + self._is_enforced_duration_of_new_window = is_enforced_duration_of_new_window + + 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/change_scheduling_plan_compartment_details.py b/src/oci/database/models/change_scheduling_plan_compartment_details.py new file mode 100644 index 0000000000..991508d450 --- /dev/null +++ b/src/oci/database/models/change_scheduling_plan_compartment_details.py @@ -0,0 +1,76 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ChangeSchedulingPlanCompartmentDetails(object): + """ + The configuration details for moving the Scheduling Plan. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeSchedulingPlanCompartmentDetails 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 ChangeSchedulingPlanCompartmentDetails. + :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 ChangeSchedulingPlanCompartmentDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ChangeSchedulingPlanCompartmentDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ChangeSchedulingPlanCompartmentDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ChangeSchedulingPlanCompartmentDetails. + :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/database/models/change_scheduling_policy_compartment_details.py b/src/oci/database/models/change_scheduling_policy_compartment_details.py new file mode 100644 index 0000000000..c346741adf --- /dev/null +++ b/src/oci/database/models/change_scheduling_policy_compartment_details.py @@ -0,0 +1,76 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ChangeSchedulingPolicyCompartmentDetails(object): + """ + The configuration details for moving the Scheduling Policy. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeSchedulingPolicyCompartmentDetails 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 ChangeSchedulingPolicyCompartmentDetails. + :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 ChangeSchedulingPolicyCompartmentDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ChangeSchedulingPolicyCompartmentDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ChangeSchedulingPolicyCompartmentDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ChangeSchedulingPolicyCompartmentDetails. + :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/database/models/cloud_exadata_infrastructure.py b/src/oci/database/models/cloud_exadata_infrastructure.py index 25fa2aa71f..1bb2988025 100644 --- a/src/oci/database/models/cloud_exadata_infrastructure.py +++ b/src/oci/database/models/cloud_exadata_infrastructure.py @@ -194,6 +194,10 @@ def __init__(self, **kwargs): The value to assign to the defined_file_system_configurations property of this CloudExadataInfrastructure. :type defined_file_system_configurations: list[oci.database.models.DefinedFileSystemConfiguration] + :param is_scheduling_policy_associated: + The value to assign to the is_scheduling_policy_associated property of this CloudExadataInfrastructure. + :type is_scheduling_policy_associated: bool + """ self.swagger_types = { 'id': 'str', @@ -231,7 +235,8 @@ def __init__(self, **kwargs): 'db_server_version': 'str', 'monthly_storage_server_version': 'str', 'monthly_db_server_version': 'str', - 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]' + 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]', + 'is_scheduling_policy_associated': 'bool' } self.attribute_map = { @@ -270,7 +275,8 @@ def __init__(self, **kwargs): 'db_server_version': 'dbServerVersion', 'monthly_storage_server_version': 'monthlyStorageServerVersion', 'monthly_db_server_version': 'monthlyDbServerVersion', - 'defined_file_system_configurations': 'definedFileSystemConfigurations' + 'defined_file_system_configurations': 'definedFileSystemConfigurations', + 'is_scheduling_policy_associated': 'isSchedulingPolicyAssociated' } self._id = None @@ -309,6 +315,7 @@ def __init__(self, **kwargs): self._monthly_storage_server_version = None self._monthly_db_server_version = None self._defined_file_system_configurations = None + self._is_scheduling_policy_associated = None @property def id(self): @@ -1234,6 +1241,30 @@ def defined_file_system_configurations(self, defined_file_system_configurations) """ self._defined_file_system_configurations = defined_file_system_configurations + @property + def is_scheduling_policy_associated(self): + """ + Gets the is_scheduling_policy_associated of this CloudExadataInfrastructure. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :return: The is_scheduling_policy_associated of this CloudExadataInfrastructure. + :rtype: bool + """ + return self._is_scheduling_policy_associated + + @is_scheduling_policy_associated.setter + def is_scheduling_policy_associated(self, is_scheduling_policy_associated): + """ + Sets the is_scheduling_policy_associated of this CloudExadataInfrastructure. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :param is_scheduling_policy_associated: The is_scheduling_policy_associated of this CloudExadataInfrastructure. + :type: bool + """ + self._is_scheduling_policy_associated = is_scheduling_policy_associated + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/cloud_exadata_infrastructure_summary.py b/src/oci/database/models/cloud_exadata_infrastructure_summary.py index 9f082160ba..bb4e17e99e 100644 --- a/src/oci/database/models/cloud_exadata_infrastructure_summary.py +++ b/src/oci/database/models/cloud_exadata_infrastructure_summary.py @@ -194,6 +194,10 @@ def __init__(self, **kwargs): The value to assign to the defined_file_system_configurations property of this CloudExadataInfrastructureSummary. :type defined_file_system_configurations: list[oci.database.models.DefinedFileSystemConfiguration] + :param is_scheduling_policy_associated: + The value to assign to the is_scheduling_policy_associated property of this CloudExadataInfrastructureSummary. + :type is_scheduling_policy_associated: bool + """ self.swagger_types = { 'id': 'str', @@ -231,7 +235,8 @@ def __init__(self, **kwargs): 'db_server_version': 'str', 'monthly_storage_server_version': 'str', 'monthly_db_server_version': 'str', - 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]' + 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]', + 'is_scheduling_policy_associated': 'bool' } self.attribute_map = { @@ -270,7 +275,8 @@ def __init__(self, **kwargs): 'db_server_version': 'dbServerVersion', 'monthly_storage_server_version': 'monthlyStorageServerVersion', 'monthly_db_server_version': 'monthlyDbServerVersion', - 'defined_file_system_configurations': 'definedFileSystemConfigurations' + 'defined_file_system_configurations': 'definedFileSystemConfigurations', + 'is_scheduling_policy_associated': 'isSchedulingPolicyAssociated' } self._id = None @@ -309,6 +315,7 @@ def __init__(self, **kwargs): self._monthly_storage_server_version = None self._monthly_db_server_version = None self._defined_file_system_configurations = None + self._is_scheduling_policy_associated = None @property def id(self): @@ -1234,6 +1241,30 @@ def defined_file_system_configurations(self, defined_file_system_configurations) """ self._defined_file_system_configurations = defined_file_system_configurations + @property + def is_scheduling_policy_associated(self): + """ + Gets the is_scheduling_policy_associated of this CloudExadataInfrastructureSummary. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :return: The is_scheduling_policy_associated of this CloudExadataInfrastructureSummary. + :rtype: bool + """ + return self._is_scheduling_policy_associated + + @is_scheduling_policy_associated.setter + def is_scheduling_policy_associated(self, is_scheduling_policy_associated): + """ + Sets the is_scheduling_policy_associated of this CloudExadataInfrastructureSummary. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :param is_scheduling_policy_associated: The is_scheduling_policy_associated of this CloudExadataInfrastructureSummary. + :type: bool + """ + self._is_scheduling_policy_associated = is_scheduling_policy_associated + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/create_autonomous_database_base.py b/src/oci/database/models/create_autonomous_database_base.py index ce6f27b636..01bb020d2f 100644 --- a/src/oci/database/models/create_autonomous_database_base.py +++ b/src/oci/database/models/create_autonomous_database_base.py @@ -1189,9 +1189,7 @@ def is_auto_scaling_enabled(self, is_auto_scaling_enabled): def is_dev_tier(self): """ Gets the is_dev_tier of this CreateAutonomousDatabaseBase. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :return: The is_dev_tier of this CreateAutonomousDatabaseBase. @@ -1203,9 +1201,7 @@ def is_dev_tier(self): def is_dev_tier(self, is_dev_tier): """ Sets the is_dev_tier of this CreateAutonomousDatabaseBase. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :param is_dev_tier: The is_dev_tier of this CreateAutonomousDatabaseBase. diff --git a/src/oci/database/models/create_data_guard_association_with_new_db_system_details.py b/src/oci/database/models/create_data_guard_association_with_new_db_system_details.py index e823a31b76..9ec67370e1 100644 --- a/src/oci/database/models/create_data_guard_association_with_new_db_system_details.py +++ b/src/oci/database/models/create_data_guard_association_with_new_db_system_details.py @@ -114,6 +114,10 @@ def __init__(self, **kwargs): The value to assign to the hostname property of this CreateDataGuardAssociationWithNewDbSystemDetails. :type hostname: str + :param domain: + The value to assign to the domain property of this CreateDataGuardAssociationWithNewDbSystemDetails. + :type domain: str + :param time_zone: The value to assign to the time_zone property of this CreateDataGuardAssociationWithNewDbSystemDetails. :type time_zone: str @@ -171,6 +175,7 @@ def __init__(self, **kwargs): 'nsg_ids': 'list[str]', 'backup_network_nsg_ids': 'list[str]', 'hostname': 'str', + 'domain': 'str', 'time_zone': 'str', 'fault_domains': 'list[str]', 'private_ip': 'str', @@ -201,6 +206,7 @@ def __init__(self, **kwargs): 'nsg_ids': 'nsgIds', 'backup_network_nsg_ids': 'backupNetworkNsgIds', 'hostname': 'hostname', + 'domain': 'domain', 'time_zone': 'timeZone', 'fault_domains': 'faultDomains', 'private_ip': 'privateIp', @@ -230,6 +236,7 @@ def __init__(self, **kwargs): self._nsg_ids = None self._backup_network_nsg_ids = None self._hostname = None + self._domain = None self._time_zone = None self._fault_domains = None self._private_ip = None @@ -526,6 +533,34 @@ def hostname(self, hostname): """ self._hostname = hostname + @property + def domain(self): + """ + Gets the domain of this CreateDataGuardAssociationWithNewDbSystemDetails. + A domain name used for the DB system. If the Oracle-provided Internet and VCN + Resolver is enabled for the specified subnet, the domain name for the subnet is used + (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted. + + + :return: The domain of this CreateDataGuardAssociationWithNewDbSystemDetails. + :rtype: str + """ + return self._domain + + @domain.setter + def domain(self, domain): + """ + Sets the domain of this CreateDataGuardAssociationWithNewDbSystemDetails. + A domain name used for the DB system. If the Oracle-provided Internet and VCN + Resolver is enabled for the specified subnet, the domain name for the subnet is used + (do not provide one). Otherwise, provide a valid DNS domain name. Hyphens (-) are not permitted. + + + :param domain: The domain of this CreateDataGuardAssociationWithNewDbSystemDetails. + :type: str + """ + self._domain = domain + @property def time_zone(self): """ diff --git a/src/oci/database/models/create_exadb_vm_cluster_details.py b/src/oci/database/models/create_exadb_vm_cluster_details.py index 696c3cd628..75199014fa 100644 --- a/src/oci/database/models/create_exadb_vm_cluster_details.py +++ b/src/oci/database/models/create_exadb_vm_cluster_details.py @@ -815,7 +815,12 @@ def backup_network_nsg_ids(self, backup_network_nsg_ids): def grid_image_id(self): """ **[Required]** Gets the grid_image_id of this CreateExadbVmClusterDetails. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :return: The grid_image_id of this CreateExadbVmClusterDetails. @@ -827,7 +832,12 @@ def grid_image_id(self): def grid_image_id(self, grid_image_id): """ Sets the grid_image_id of this CreateExadbVmClusterDetails. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :param grid_image_id: The grid_image_id of this CreateExadbVmClusterDetails. diff --git a/src/oci/database/models/create_execution_action_details.py b/src/oci/database/models/create_execution_action_details.py new file mode 100644 index 0000000000..0e69596eff --- /dev/null +++ b/src/oci/database/models/create_execution_action_details.py @@ -0,0 +1,304 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateExecutionActionDetails(object): + """ + Request to create execution action resource. + """ + + #: A constant which can be used with the action_type property of a CreateExecutionActionDetails. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a CreateExecutionActionDetails. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a CreateExecutionActionDetails. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + def __init__(self, **kwargs): + """ + Initializes a new CreateExecutionActionDetails 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 CreateExecutionActionDetails. + :type compartment_id: str + + :param execution_window_id: + The value to assign to the execution_window_id property of this CreateExecutionActionDetails. + :type execution_window_id: str + + :param action_type: + The value to assign to the action_type property of this CreateExecutionActionDetails. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + :type action_type: str + + :param action_params: + The value to assign to the action_params property of this CreateExecutionActionDetails. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this CreateExecutionActionDetails. + :type action_members: list[oci.database.models.ExecutionActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExecutionActionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExecutionActionDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'execution_window_id': 'str', + 'action_type': 'str', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ExecutionActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'execution_window_id': 'executionWindowId', + 'action_type': 'actionType', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._execution_window_id = None + self._action_type = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + Gets the compartment_id of this CreateExecutionActionDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExecutionActionDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExecutionActionDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExecutionActionDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def execution_window_id(self): + """ + **[Required]** Gets the execution_window_id of this CreateExecutionActionDetails. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_window_id of this CreateExecutionActionDetails. + :rtype: str + """ + return self._execution_window_id + + @execution_window_id.setter + def execution_window_id(self, execution_window_id): + """ + Sets the execution_window_id of this CreateExecutionActionDetails. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_window_id: The execution_window_id of this CreateExecutionActionDetails. + :type: str + """ + self._execution_window_id = execution_window_id + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this CreateExecutionActionDetails. + The action type of the execution action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + + :return: The action_type of this CreateExecutionActionDetails. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this CreateExecutionActionDetails. + The action type of the execution action being performed + + + :param action_type: The action_type of this CreateExecutionActionDetails. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + raise ValueError( + f"Invalid value for `action_type`, must be None or one of {allowed_values}" + ) + self._action_type = action_type + + @property + def action_params(self): + """ + Gets the action_params of this CreateExecutionActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this CreateExecutionActionDetails. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this CreateExecutionActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this CreateExecutionActionDetails. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this CreateExecutionActionDetails. + List of action members of this execution action. + + + :return: The action_members of this CreateExecutionActionDetails. + :rtype: list[oci.database.models.ExecutionActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this CreateExecutionActionDetails. + List of action members of this execution action. + + + :param action_members: The action_members of this CreateExecutionActionDetails. + :type: list[oci.database.models.ExecutionActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExecutionActionDetails. + 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 CreateExecutionActionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExecutionActionDetails. + 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 CreateExecutionActionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExecutionActionDetails. + 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 CreateExecutionActionDetails. + :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 CreateExecutionActionDetails. + 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 CreateExecutionActionDetails. + :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_execution_window_details.py b/src/oci/database/models/create_execution_window_details.py new file mode 100644 index 0000000000..0a67f27ea7 --- /dev/null +++ b/src/oci/database/models/create_execution_window_details.py @@ -0,0 +1,282 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateExecutionWindowDetails(object): + """ + Request to create an execution window resource under an execution resource. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateExecutionWindowDetails 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 CreateExecutionWindowDetails. + :type compartment_id: str + + :param execution_resource_id: + The value to assign to the execution_resource_id property of this CreateExecutionWindowDetails. + :type execution_resource_id: str + + :param time_scheduled: + The value to assign to the time_scheduled property of this CreateExecutionWindowDetails. + :type time_scheduled: datetime + + :param window_duration_in_mins: + The value to assign to the window_duration_in_mins property of this CreateExecutionWindowDetails. + :type window_duration_in_mins: int + + :param is_enforced_duration: + The value to assign to the is_enforced_duration property of this CreateExecutionWindowDetails. + :type is_enforced_duration: bool + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateExecutionWindowDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateExecutionWindowDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'execution_resource_id': 'str', + 'time_scheduled': 'datetime', + 'window_duration_in_mins': 'int', + 'is_enforced_duration': 'bool', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'execution_resource_id': 'executionResourceId', + 'time_scheduled': 'timeScheduled', + 'window_duration_in_mins': 'windowDurationInMins', + 'is_enforced_duration': 'isEnforcedDuration', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._execution_resource_id = None + self._time_scheduled = None + self._window_duration_in_mins = None + self._is_enforced_duration = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateExecutionWindowDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateExecutionWindowDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateExecutionWindowDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateExecutionWindowDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def execution_resource_id(self): + """ + **[Required]** Gets the execution_resource_id of this CreateExecutionWindowDetails. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_resource_id of this CreateExecutionWindowDetails. + :rtype: str + """ + return self._execution_resource_id + + @execution_resource_id.setter + def execution_resource_id(self, execution_resource_id): + """ + Sets the execution_resource_id of this CreateExecutionWindowDetails. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_resource_id: The execution_resource_id of this CreateExecutionWindowDetails. + :type: str + """ + self._execution_resource_id = execution_resource_id + + @property + def time_scheduled(self): + """ + **[Required]** Gets the time_scheduled of this CreateExecutionWindowDetails. + The scheduled start date and time of the execution window. + + + :return: The time_scheduled of this CreateExecutionWindowDetails. + :rtype: datetime + """ + return self._time_scheduled + + @time_scheduled.setter + def time_scheduled(self, time_scheduled): + """ + Sets the time_scheduled of this CreateExecutionWindowDetails. + The scheduled start date and time of the execution window. + + + :param time_scheduled: The time_scheduled of this CreateExecutionWindowDetails. + :type: datetime + """ + self._time_scheduled = time_scheduled + + @property + def window_duration_in_mins(self): + """ + **[Required]** Gets the window_duration_in_mins of this CreateExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The window_duration_in_mins of this CreateExecutionWindowDetails. + :rtype: int + """ + return self._window_duration_in_mins + + @window_duration_in_mins.setter + def window_duration_in_mins(self, window_duration_in_mins): + """ + Sets the window_duration_in_mins of this CreateExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param window_duration_in_mins: The window_duration_in_mins of this CreateExecutionWindowDetails. + :type: int + """ + self._window_duration_in_mins = window_duration_in_mins + + @property + def is_enforced_duration(self): + """ + Gets the is_enforced_duration of this CreateExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration of this CreateExecutionWindowDetails. + :rtype: bool + """ + return self._is_enforced_duration + + @is_enforced_duration.setter + def is_enforced_duration(self, is_enforced_duration): + """ + Sets the is_enforced_duration of this CreateExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration: The is_enforced_duration of this CreateExecutionWindowDetails. + :type: bool + """ + self._is_enforced_duration = is_enforced_duration + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateExecutionWindowDetails. + 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 CreateExecutionWindowDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateExecutionWindowDetails. + 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 CreateExecutionWindowDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateExecutionWindowDetails. + 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 CreateExecutionWindowDetails. + :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 CreateExecutionWindowDetails. + 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 CreateExecutionWindowDetails. + :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_pluggable_database_creation_type_details.py b/src/oci/database/models/create_pluggable_database_creation_type_details.py index a22e796111..7d091537d0 100644 --- a/src/oci/database/models/create_pluggable_database_creation_type_details.py +++ b/src/oci/database/models/create_pluggable_database_creation_type_details.py @@ -16,14 +16,12 @@ class CreatePluggableDatabaseCreationTypeDetails(object): Use `LOCAL_CLONE_PDB` for creating a new PDB using Local Clone on Source Pluggable Database. This will Clone and starts a pluggable database (PDB) in the same database (CDB) as the source PDB. The source PDB must be in the `READ_WRITE` openMode to perform the clone operation. - sourcePluggableDatabaseSnapshotId and isThinClone options are supported only for Exadata VM cluster on Exascale Infrastructure. isThinClone options are supported only for Exadata VM cluster on Exascale Infrastructure. Use `REMOTE_CLONE_PDB` for creating a new PDB using Remote Clone on Source Pluggable Database. This will Clone a pluggable database (PDB) to a different database from the source PDB. The cloned PDB will be started upon completion of the clone operation. The source PDB must be in the `READ_WRITE` openMode when performing the clone. For Exadata Cloud@Customer instances, the source pluggable database (PDB) must be on the same Exadata Infrastructure as the target container database (CDB) to create a remote clone. - sourcePluggableDatabaseSnapshotId and isThinClone options are supported only for Exadata VM cluster on Exascale Infrastructure. isThinClone options are supported only for Exadata VM cluster on Exascale Infrastructure. Use `RELOCATE_PDB` for relocating the Pluggable Database from Source CDB and creating it in target CDB. This will relocate a pluggable database (PDB) to a different database from the source PDB. The source PDB must be in the `READ_WRITE` openMode when diff --git a/src/oci/database/models/create_scheduled_action_details.py b/src/oci/database/models/create_scheduled_action_details.py new file mode 100644 index 0000000000..11360de4dc --- /dev/null +++ b/src/oci/database/models/create_scheduled_action_details.py @@ -0,0 +1,339 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateScheduledActionDetails(object): + """ + Request to create Scheduled Action resource. + """ + + #: A constant which can be used with the action_type property of a CreateScheduledActionDetails. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a CreateScheduledActionDetails. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a CreateScheduledActionDetails. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + def __init__(self, **kwargs): + """ + Initializes a new CreateScheduledActionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param action_type: + The value to assign to the action_type property of this CreateScheduledActionDetails. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + :type action_type: str + + :param action_params: + The value to assign to the action_params property of this CreateScheduledActionDetails. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this CreateScheduledActionDetails. + :type action_members: list[oci.database.models.ActionMember] + + :param scheduling_plan_id: + The value to assign to the scheduling_plan_id property of this CreateScheduledActionDetails. + :type scheduling_plan_id: str + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this CreateScheduledActionDetails. + :type scheduling_window_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateScheduledActionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateScheduledActionDetails. + :type defined_tags: dict(str, dict(str, object)) + + :param compartment_id: + The value to assign to the compartment_id property of this CreateScheduledActionDetails. + :type compartment_id: str + + """ + self.swagger_types = { + 'action_type': 'str', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ActionMember]', + 'scheduling_plan_id': 'str', + 'scheduling_window_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'compartment_id': 'str' + } + + self.attribute_map = { + 'action_type': 'actionType', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'scheduling_plan_id': 'schedulingPlanId', + 'scheduling_window_id': 'schedulingWindowId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'compartment_id': 'compartmentId' + } + + self._action_type = None + self._action_params = None + self._action_members = None + self._scheduling_plan_id = None + self._scheduling_window_id = None + self._freeform_tags = None + self._defined_tags = None + self._compartment_id = None + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this CreateScheduledActionDetails. + The type of the scheduled action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + + :return: The action_type of this CreateScheduledActionDetails. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this CreateScheduledActionDetails. + The type of the scheduled action being performed + + + :param action_type: The action_type of this CreateScheduledActionDetails. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + raise ValueError( + f"Invalid value for `action_type`, must be None or one of {allowed_values}" + ) + self._action_type = action_type + + @property + def action_params(self): + """ + Gets the action_params of this CreateScheduledActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this CreateScheduledActionDetails. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this CreateScheduledActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this CreateScheduledActionDetails. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this CreateScheduledActionDetails. + The list of action members in a scheduled action. + + + :return: The action_members of this CreateScheduledActionDetails. + :rtype: list[oci.database.models.ActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this CreateScheduledActionDetails. + The list of action members in a scheduled action. + + + :param action_members: The action_members of this CreateScheduledActionDetails. + :type: list[oci.database.models.ActionMember] + """ + self._action_members = action_members + + @property + def scheduling_plan_id(self): + """ + **[Required]** Gets the scheduling_plan_id of this CreateScheduledActionDetails. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_plan_id of this CreateScheduledActionDetails. + :rtype: str + """ + return self._scheduling_plan_id + + @scheduling_plan_id.setter + def scheduling_plan_id(self, scheduling_plan_id): + """ + Sets the scheduling_plan_id of this CreateScheduledActionDetails. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_plan_id: The scheduling_plan_id of this CreateScheduledActionDetails. + :type: str + """ + self._scheduling_plan_id = scheduling_plan_id + + @property + def scheduling_window_id(self): + """ + **[Required]** Gets the scheduling_window_id of this CreateScheduledActionDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_window_id of this CreateScheduledActionDetails. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this CreateScheduledActionDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_window_id: The scheduling_window_id of this CreateScheduledActionDetails. + :type: str + """ + self._scheduling_window_id = scheduling_window_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateScheduledActionDetails. + 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 CreateScheduledActionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateScheduledActionDetails. + 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 CreateScheduledActionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateScheduledActionDetails. + 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 CreateScheduledActionDetails. + :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 CreateScheduledActionDetails. + 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 CreateScheduledActionDetails. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateScheduledActionDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateScheduledActionDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateScheduledActionDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateScheduledActionDetails. + :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/database/models/create_scheduling_plan_details.py b/src/oci/database/models/create_scheduling_plan_details.py new file mode 100644 index 0000000000..f5885d7958 --- /dev/null +++ b/src/oci/database/models/create_scheduling_plan_details.py @@ -0,0 +1,306 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateSchedulingPlanDetails(object): + """ + Request to create Scheduling Plan. + """ + + #: A constant which can be used with the service_type property of a CreateSchedulingPlanDetails. + #: This constant has a value of "EXACC" + SERVICE_TYPE_EXACC = "EXACC" + + #: A constant which can be used with the service_type property of a CreateSchedulingPlanDetails. + #: This constant has a value of "EXACS" + SERVICE_TYPE_EXACS = "EXACS" + + #: A constant which can be used with the service_type property of a CreateSchedulingPlanDetails. + #: This constant has a value of "FPPPCS" + SERVICE_TYPE_FPPPCS = "FPPPCS" + + def __init__(self, **kwargs): + """ + Initializes a new CreateSchedulingPlanDetails 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 CreateSchedulingPlanDetails. + :type compartment_id: str + + :param scheduling_policy_id: + The value to assign to the scheduling_policy_id property of this CreateSchedulingPlanDetails. + :type scheduling_policy_id: str + + :param resource_id: + The value to assign to the resource_id property of this CreateSchedulingPlanDetails. + :type resource_id: str + + :param service_type: + The value to assign to the service_type property of this CreateSchedulingPlanDetails. + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS" + :type service_type: str + + :param is_using_recommended_scheduled_actions: + The value to assign to the is_using_recommended_scheduled_actions property of this CreateSchedulingPlanDetails. + :type is_using_recommended_scheduled_actions: bool + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateSchedulingPlanDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateSchedulingPlanDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'scheduling_policy_id': 'str', + 'resource_id': 'str', + 'service_type': 'str', + 'is_using_recommended_scheduled_actions': 'bool', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'scheduling_policy_id': 'schedulingPolicyId', + 'resource_id': 'resourceId', + 'service_type': 'serviceType', + 'is_using_recommended_scheduled_actions': 'isUsingRecommendedScheduledActions', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._scheduling_policy_id = None + self._resource_id = None + self._service_type = None + self._is_using_recommended_scheduled_actions = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateSchedulingPlanDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateSchedulingPlanDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def scheduling_policy_id(self): + """ + **[Required]** Gets the scheduling_policy_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_policy_id of this CreateSchedulingPlanDetails. + :rtype: str + """ + return self._scheduling_policy_id + + @scheduling_policy_id.setter + def scheduling_policy_id(self, scheduling_policy_id): + """ + Sets the scheduling_policy_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_policy_id: The scheduling_policy_id of this CreateSchedulingPlanDetails. + :type: str + """ + self._scheduling_policy_id = scheduling_policy_id + + @property + def resource_id(self): + """ + **[Required]** Gets the resource_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The resource_id of this CreateSchedulingPlanDetails. + :rtype: str + """ + return self._resource_id + + @resource_id.setter + def resource_id(self, resource_id): + """ + Sets the resource_id of this CreateSchedulingPlanDetails. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param resource_id: The resource_id of this CreateSchedulingPlanDetails. + :type: str + """ + self._resource_id = resource_id + + @property + def service_type(self): + """ + **[Required]** Gets the service_type of this CreateSchedulingPlanDetails. + The service type of the Scheduling Plan. + + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS" + + + :return: The service_type of this CreateSchedulingPlanDetails. + :rtype: str + """ + return self._service_type + + @service_type.setter + def service_type(self, service_type): + """ + Sets the service_type of this CreateSchedulingPlanDetails. + The service type of the Scheduling Plan. + + + :param service_type: The service_type of this CreateSchedulingPlanDetails. + :type: str + """ + allowed_values = ["EXACC", "EXACS", "FPPPCS"] + if not value_allowed_none_or_none_sentinel(service_type, allowed_values): + raise ValueError( + f"Invalid value for `service_type`, must be None or one of {allowed_values}" + ) + self._service_type = service_type + + @property + def is_using_recommended_scheduled_actions(self): + """ + Gets the is_using_recommended_scheduled_actions of this CreateSchedulingPlanDetails. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :return: The is_using_recommended_scheduled_actions of this CreateSchedulingPlanDetails. + :rtype: bool + """ + return self._is_using_recommended_scheduled_actions + + @is_using_recommended_scheduled_actions.setter + def is_using_recommended_scheduled_actions(self, is_using_recommended_scheduled_actions): + """ + Sets the is_using_recommended_scheduled_actions of this CreateSchedulingPlanDetails. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :param is_using_recommended_scheduled_actions: The is_using_recommended_scheduled_actions of this CreateSchedulingPlanDetails. + :type: bool + """ + self._is_using_recommended_scheduled_actions = is_using_recommended_scheduled_actions + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateSchedulingPlanDetails. + 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 CreateSchedulingPlanDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateSchedulingPlanDetails. + 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 CreateSchedulingPlanDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateSchedulingPlanDetails. + 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 CreateSchedulingPlanDetails. + :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 CreateSchedulingPlanDetails. + 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 CreateSchedulingPlanDetails. + :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_scheduling_policy_details.py b/src/oci/database/models/create_scheduling_policy_details.py new file mode 100644 index 0000000000..ed4e694fd9 --- /dev/null +++ b/src/oci/database/models/create_scheduling_policy_details.py @@ -0,0 +1,267 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateSchedulingPolicyDetails(object): + """ + Request to create Scheduling Policy resource with Maintenance windows per cadence. + """ + + #: A constant which can be used with the cadence property of a CreateSchedulingPolicyDetails. + #: This constant has a value of "HALFYEARLY" + CADENCE_HALFYEARLY = "HALFYEARLY" + + #: A constant which can be used with the cadence property of a CreateSchedulingPolicyDetails. + #: This constant has a value of "QUARTERLY" + CADENCE_QUARTERLY = "QUARTERLY" + + #: A constant which can be used with the cadence property of a CreateSchedulingPolicyDetails. + #: This constant has a value of "MONTHLY" + CADENCE_MONTHLY = "MONTHLY" + + def __init__(self, **kwargs): + """ + Initializes a new CreateSchedulingPolicyDetails 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 CreateSchedulingPolicyDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateSchedulingPolicyDetails. + :type display_name: str + + :param cadence: + The value to assign to the cadence property of this CreateSchedulingPolicyDetails. + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY" + :type cadence: str + + :param cadence_start_month: + The value to assign to the cadence_start_month property of this CreateSchedulingPolicyDetails. + :type cadence_start_month: oci.database.models.Month + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateSchedulingPolicyDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateSchedulingPolicyDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'cadence': 'str', + 'cadence_start_month': 'Month', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'cadence': 'cadence', + 'cadence_start_month': 'cadenceStartMonth', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._cadence = None + self._cadence_start_month = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateSchedulingPolicyDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateSchedulingPolicyDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateSchedulingPolicyDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateSchedulingPolicyDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateSchedulingPolicyDetails. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :return: The display_name of this CreateSchedulingPolicyDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateSchedulingPolicyDetails. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :param display_name: The display_name of this CreateSchedulingPolicyDetails. + :type: str + """ + self._display_name = display_name + + @property + def cadence(self): + """ + **[Required]** Gets the cadence of this CreateSchedulingPolicyDetails. + The cadence period. + + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY" + + + :return: The cadence of this CreateSchedulingPolicyDetails. + :rtype: str + """ + return self._cadence + + @cadence.setter + def cadence(self, cadence): + """ + Sets the cadence of this CreateSchedulingPolicyDetails. + The cadence period. + + + :param cadence: The cadence of this CreateSchedulingPolicyDetails. + :type: str + """ + allowed_values = ["HALFYEARLY", "QUARTERLY", "MONTHLY"] + if not value_allowed_none_or_none_sentinel(cadence, allowed_values): + raise ValueError( + f"Invalid value for `cadence`, must be None or one of {allowed_values}" + ) + self._cadence = cadence + + @property + def cadence_start_month(self): + """ + Gets the cadence_start_month of this CreateSchedulingPolicyDetails. + Start of the month to be followed during the cadence period. + + + :return: The cadence_start_month of this CreateSchedulingPolicyDetails. + :rtype: oci.database.models.Month + """ + return self._cadence_start_month + + @cadence_start_month.setter + def cadence_start_month(self, cadence_start_month): + """ + Sets the cadence_start_month of this CreateSchedulingPolicyDetails. + Start of the month to be followed during the cadence period. + + + :param cadence_start_month: The cadence_start_month of this CreateSchedulingPolicyDetails. + :type: oci.database.models.Month + """ + self._cadence_start_month = cadence_start_month + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateSchedulingPolicyDetails. + 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 CreateSchedulingPolicyDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateSchedulingPolicyDetails. + 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 CreateSchedulingPolicyDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateSchedulingPolicyDetails. + 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 CreateSchedulingPolicyDetails. + :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 CreateSchedulingPolicyDetails. + 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 CreateSchedulingPolicyDetails. + :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_scheduling_window_details.py b/src/oci/database/models/create_scheduling_window_details.py new file mode 100644 index 0000000000..e298ae200d --- /dev/null +++ b/src/oci/database/models/create_scheduling_window_details.py @@ -0,0 +1,181 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreateSchedulingWindowDetails(object): + """ + Request to create Scheduling Window resource. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreateSchedulingWindowDetails 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 CreateSchedulingWindowDetails. + :type compartment_id: str + + :param window_preference: + The value to assign to the window_preference property of this CreateSchedulingWindowDetails. + :type window_preference: oci.database.models.WindowPreferenceDetail + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateSchedulingWindowDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateSchedulingWindowDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'window_preference': 'WindowPreferenceDetail', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'window_preference': 'windowPreference', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._window_preference = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + Gets the compartment_id of this CreateSchedulingWindowDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this CreateSchedulingWindowDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateSchedulingWindowDetails. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this CreateSchedulingWindowDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def window_preference(self): + """ + **[Required]** Gets the window_preference of this CreateSchedulingWindowDetails. + + :return: The window_preference of this CreateSchedulingWindowDetails. + :rtype: oci.database.models.WindowPreferenceDetail + """ + return self._window_preference + + @window_preference.setter + def window_preference(self, window_preference): + """ + Sets the window_preference of this CreateSchedulingWindowDetails. + + :param window_preference: The window_preference of this CreateSchedulingWindowDetails. + :type: oci.database.models.WindowPreferenceDetail + """ + self._window_preference = window_preference + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateSchedulingWindowDetails. + 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 CreateSchedulingWindowDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateSchedulingWindowDetails. + 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 CreateSchedulingWindowDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateSchedulingWindowDetails. + 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 CreateSchedulingWindowDetails. + :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 CreateSchedulingWindowDetails. + 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 CreateSchedulingWindowDetails. + :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/exadata_infrastructure.py b/src/oci/database/models/exadata_infrastructure.py index a40d7964ad..66b2ee5b46 100644 --- a/src/oci/database/models/exadata_infrastructure.py +++ b/src/oci/database/models/exadata_infrastructure.py @@ -298,6 +298,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this ExadataInfrastructure. :type defined_tags: dict(str, dict(str, object)) + :param is_scheduling_policy_associated: + The value to assign to the is_scheduling_policy_associated property of this ExadataInfrastructure. + :type is_scheduling_policy_associated: bool + """ self.swagger_types = { 'id': 'str', @@ -348,7 +352,8 @@ def __init__(self, **kwargs): 'availability_domain': 'str', 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'is_scheduling_policy_associated': 'bool' } self.attribute_map = { @@ -400,7 +405,8 @@ def __init__(self, **kwargs): 'availability_domain': 'availabilityDomain', 'defined_file_system_configurations': 'definedFileSystemConfigurations', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'is_scheduling_policy_associated': 'isSchedulingPolicyAssociated' } self._id = None @@ -452,6 +458,7 @@ def __init__(self, **kwargs): self._defined_file_system_configurations = None self._freeform_tags = None self._defined_tags = None + self._is_scheduling_policy_associated = None @property def id(self): @@ -1683,6 +1690,30 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def is_scheduling_policy_associated(self): + """ + Gets the is_scheduling_policy_associated of this ExadataInfrastructure. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :return: The is_scheduling_policy_associated of this ExadataInfrastructure. + :rtype: bool + """ + return self._is_scheduling_policy_associated + + @is_scheduling_policy_associated.setter + def is_scheduling_policy_associated(self, is_scheduling_policy_associated): + """ + Sets the is_scheduling_policy_associated of this ExadataInfrastructure. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :param is_scheduling_policy_associated: The is_scheduling_policy_associated of this ExadataInfrastructure. + :type: bool + """ + self._is_scheduling_policy_associated = is_scheduling_policy_associated + 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 883dfe29c2..3050f2a9c4 100644 --- a/src/oci/database/models/exadata_infrastructure_summary.py +++ b/src/oci/database/models/exadata_infrastructure_summary.py @@ -299,6 +299,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this ExadataInfrastructureSummary. :type defined_tags: dict(str, dict(str, object)) + :param is_scheduling_policy_associated: + The value to assign to the is_scheduling_policy_associated property of this ExadataInfrastructureSummary. + :type is_scheduling_policy_associated: bool + """ self.swagger_types = { 'id': 'str', @@ -349,7 +353,8 @@ def __init__(self, **kwargs): 'availability_domain': 'str', 'defined_file_system_configurations': 'list[DefinedFileSystemConfiguration]', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'is_scheduling_policy_associated': 'bool' } self.attribute_map = { @@ -401,7 +406,8 @@ def __init__(self, **kwargs): 'availability_domain': 'availabilityDomain', 'defined_file_system_configurations': 'definedFileSystemConfigurations', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'is_scheduling_policy_associated': 'isSchedulingPolicyAssociated' } self._id = None @@ -453,6 +459,7 @@ def __init__(self, **kwargs): self._defined_file_system_configurations = None self._freeform_tags = None self._defined_tags = None + self._is_scheduling_policy_associated = None @property def id(self): @@ -1684,6 +1691,30 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def is_scheduling_policy_associated(self): + """ + Gets the is_scheduling_policy_associated of this ExadataInfrastructureSummary. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :return: The is_scheduling_policy_associated of this ExadataInfrastructureSummary. + :rtype: bool + """ + return self._is_scheduling_policy_associated + + @is_scheduling_policy_associated.setter + def is_scheduling_policy_associated(self, is_scheduling_policy_associated): + """ + Sets the is_scheduling_policy_associated of this ExadataInfrastructureSummary. + If true, the infrastructure is using granular maintenance scheduling preference. + + + :param is_scheduling_policy_associated: The is_scheduling_policy_associated of this ExadataInfrastructureSummary. + :type: bool + """ + self._is_scheduling_policy_associated = is_scheduling_policy_associated + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/exadb_vm_cluster.py b/src/oci/database/models/exadb_vm_cluster.py index 05b2a93510..fe46e768c7 100644 --- a/src/oci/database/models/exadb_vm_cluster.py +++ b/src/oci/database/models/exadb_vm_cluster.py @@ -961,7 +961,12 @@ def gi_version(self, gi_version): def grid_image_id(self): """ Gets the grid_image_id of this ExadbVmCluster. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :return: The grid_image_id of this ExadbVmCluster. @@ -973,7 +978,12 @@ def grid_image_id(self): def grid_image_id(self, grid_image_id): """ Sets the grid_image_id of this ExadbVmCluster. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :param grid_image_id: The grid_image_id of this ExadbVmCluster. diff --git a/src/oci/database/models/exadb_vm_cluster_summary.py b/src/oci/database/models/exadb_vm_cluster_summary.py index b7e67a2c62..46d7faafc3 100644 --- a/src/oci/database/models/exadb_vm_cluster_summary.py +++ b/src/oci/database/models/exadb_vm_cluster_summary.py @@ -934,7 +934,12 @@ def gi_version(self, gi_version): def grid_image_id(self): """ Gets the grid_image_id of this ExadbVmClusterSummary. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :return: The grid_image_id of this ExadbVmClusterSummary. @@ -946,7 +951,12 @@ def grid_image_id(self): def grid_image_id(self, grid_image_id): """ Sets the grid_image_id of this ExadbVmClusterSummary. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :param grid_image_id: The grid_image_id of this ExadbVmClusterSummary. diff --git a/src/oci/database/models/execution_action.py b/src/oci/database/models/execution_action.py new file mode 100644 index 0000000000..fa8fc70844 --- /dev/null +++ b/src/oci/database/models/execution_action.py @@ -0,0 +1,715 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ExecutionAction(object): + """ + Details of an execution action. + """ + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "SCHEDULED" + LIFECYCLE_STATE_SCHEDULED = "SCHEDULED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "IN_PROGRESS" + LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "CANCELED" + LIFECYCLE_STATE_CANCELED = "CANCELED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "SUCCEEDED" + LIFECYCLE_STATE_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionAction. + #: This constant has a value of "PARTIAL_SUCCESS" + LIFECYCLE_STATE_PARTIAL_SUCCESS = "PARTIAL_SUCCESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionAction. + #: This constant has a value of "DURATION_EXCEEDED" + LIFECYCLE_SUBSTATE_DURATION_EXCEEDED = "DURATION_EXCEEDED" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionAction. + #: This constant has a value of "MAINTENANCE_IN_PROGRESS" + LIFECYCLE_SUBSTATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionAction. + #: This constant has a value of "WAITING" + LIFECYCLE_SUBSTATE_WAITING = "WAITING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionAction. + #: This constant has a value of "RESCHEDULED" + LIFECYCLE_SUBSTATE_RESCHEDULED = "RESCHEDULED" + + #: A constant which can be used with the action_type property of a ExecutionAction. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ExecutionAction. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ExecutionAction. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + def __init__(self, **kwargs): + """ + Initializes a new ExecutionAction 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 ExecutionAction. + :type id: str + + :param execution_window_id: + The value to assign to the execution_window_id property of this ExecutionAction. + :type execution_window_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExecutionAction. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this ExecutionAction. + :type display_name: str + + :param description: + The value to assign to the description property of this ExecutionAction. + :type description: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExecutionAction. + Allowed values for this property are: "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_substate: + The value to assign to the lifecycle_substate property of this ExecutionAction. + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_substate: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExecutionAction. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExecutionAction. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ExecutionAction. + :type time_updated: datetime + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ExecutionAction. + :type estimated_time_in_mins: int + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this ExecutionAction. + :type total_time_taken_in_mins: int + + :param execution_action_order: + The value to assign to the execution_action_order property of this ExecutionAction. + :type execution_action_order: int + + :param action_type: + The value to assign to the action_type property of this ExecutionAction. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param action_params: + The value to assign to the action_params property of this ExecutionAction. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this ExecutionAction. + :type action_members: list[oci.database.models.ExecutionActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExecutionAction. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExecutionAction. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'execution_window_id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'lifecycle_state': 'str', + 'lifecycle_substate': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'estimated_time_in_mins': 'int', + 'total_time_taken_in_mins': 'int', + 'execution_action_order': 'int', + 'action_type': 'str', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ExecutionActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'execution_window_id': 'executionWindowId', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_substate': 'lifecycleSubstate', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', + 'execution_action_order': 'executionActionOrder', + 'action_type': 'actionType', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._execution_window_id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._lifecycle_state = None + self._lifecycle_substate = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._estimated_time_in_mins = None + self._total_time_taken_in_mins = None + self._execution_action_order = None + self._action_type = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ExecutionAction. + The `OCID`__ of the execution action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExecutionAction. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExecutionAction. + The `OCID`__ of the execution action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExecutionAction. + :type: str + """ + self._id = id + + @property + def execution_window_id(self): + """ + **[Required]** Gets the execution_window_id of this ExecutionAction. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_window_id of this ExecutionAction. + :rtype: str + """ + return self._execution_window_id + + @execution_window_id.setter + def execution_window_id(self, execution_window_id): + """ + Sets the execution_window_id of this ExecutionAction. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_window_id: The execution_window_id of this ExecutionAction. + :type: str + """ + self._execution_window_id = execution_window_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExecutionAction. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExecutionAction. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExecutionAction. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExecutionAction. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExecutionAction. + The user-friendly name for the execution action. The name does not need to be unique. + + + :return: The display_name of this ExecutionAction. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExecutionAction. + The user-friendly name for the execution action. The name does not need to be unique. + + + :param display_name: The display_name of this ExecutionAction. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this ExecutionAction. + Description of the execution action. + + + :return: The description of this ExecutionAction. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ExecutionAction. + Description of the execution action. + + + :param description: The description of this ExecutionAction. + :type: str + """ + self._description = description + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExecutionAction. + The current state of the execution action. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + Allowed values for this property are: "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExecutionAction. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExecutionAction. + The current state of the execution action. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + + :param lifecycle_state: The lifecycle_state of this ExecutionAction. + :type: str + """ + allowed_values = ["SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS"] + 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_substate(self): + """ + Gets the lifecycle_substate of this ExecutionAction. + The current sub-state of the execution action. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_substate of this ExecutionAction. + :rtype: str + """ + return self._lifecycle_substate + + @lifecycle_substate.setter + def lifecycle_substate(self, lifecycle_substate): + """ + Sets the lifecycle_substate of this ExecutionAction. + The current sub-state of the execution action. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + + :param lifecycle_substate: The lifecycle_substate of this ExecutionAction. + :type: str + """ + allowed_values = ["DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED"] + if not value_allowed_none_or_none_sentinel(lifecycle_substate, allowed_values): + lifecycle_substate = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_substate = lifecycle_substate + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExecutionAction. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExecutionAction. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExecutionAction. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExecutionAction. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this ExecutionAction. + The date and time the execution action was created. + + + :return: The time_created of this ExecutionAction. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExecutionAction. + The date and time the execution action was created. + + + :param time_created: The time_created of this ExecutionAction. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ExecutionAction. + The last date and time that the execution action was updated. + + + :return: The time_updated of this ExecutionAction. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ExecutionAction. + The last date and time that the execution action was updated. + + + :param time_updated: The time_updated of this ExecutionAction. + :type: datetime + """ + self._time_updated = time_updated + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ExecutionAction. + The estimated time of the execution action in minutes. + + + :return: The estimated_time_in_mins of this ExecutionAction. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ExecutionAction. + The estimated time of the execution action in minutes. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ExecutionAction. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this ExecutionAction. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this ExecutionAction. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this ExecutionAction. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this ExecutionAction. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + + @property + def execution_action_order(self): + """ + Gets the execution_action_order of this ExecutionAction. + The priority order of the execution action. + + + :return: The execution_action_order of this ExecutionAction. + :rtype: int + """ + return self._execution_action_order + + @execution_action_order.setter + def execution_action_order(self, execution_action_order): + """ + Sets the execution_action_order of this ExecutionAction. + The priority order of the execution action. + + + :param execution_action_order: The execution_action_order of this ExecutionAction. + :type: int + """ + self._execution_action_order = execution_action_order + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this ExecutionAction. + The action type of the execution action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this ExecutionAction. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this ExecutionAction. + The action type of the execution action being performed + + + :param action_type: The action_type of this ExecutionAction. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def action_params(self): + """ + **[Required]** Gets the action_params of this ExecutionAction. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this ExecutionAction. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this ExecutionAction. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this ExecutionAction. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this ExecutionAction. + List of action members of this execution action. + + + :return: The action_members of this ExecutionAction. + :rtype: list[oci.database.models.ExecutionActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this ExecutionAction. + List of action members of this execution action. + + + :param action_members: The action_members of this ExecutionAction. + :type: list[oci.database.models.ExecutionActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExecutionAction. + 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 ExecutionAction. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExecutionAction. + 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 ExecutionAction. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExecutionAction. + 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 ExecutionAction. + :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 ExecutionAction. + 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 ExecutionAction. + :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/execution_action_member.py b/src/oci/database/models/execution_action_member.py new file mode 100644 index 0000000000..f100d4c602 --- /dev/null +++ b/src/oci/database/models/execution_action_member.py @@ -0,0 +1,216 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ExecutionActionMember(object): + """ + The action member details. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ExecutionActionMember object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param member_order: + The value to assign to the member_order property of this ExecutionActionMember. + :type member_order: int + + :param member_id: + The value to assign to the member_id property of this ExecutionActionMember. + :type member_id: str + + :param status: + The value to assign to the status property of this ExecutionActionMember. + :type status: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ExecutionActionMember. + :type estimated_time_in_mins: int + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this ExecutionActionMember. + :type total_time_taken_in_mins: int + + """ + self.swagger_types = { + 'member_order': 'int', + 'member_id': 'str', + 'status': 'str', + 'estimated_time_in_mins': 'int', + 'total_time_taken_in_mins': 'int' + } + + self.attribute_map = { + 'member_order': 'memberOrder', + 'member_id': 'memberId', + 'status': 'status', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'total_time_taken_in_mins': 'totalTimeTakenInMins' + } + + self._member_order = None + self._member_id = None + self._status = None + self._estimated_time_in_mins = None + self._total_time_taken_in_mins = None + + @property + def member_order(self): + """ + **[Required]** Gets the member_order of this ExecutionActionMember. + The priority order of the execution action member. + + + :return: The member_order of this ExecutionActionMember. + :rtype: int + """ + return self._member_order + + @member_order.setter + def member_order(self, member_order): + """ + Sets the member_order of this ExecutionActionMember. + The priority order of the execution action member. + + + :param member_order: The member_order of this ExecutionActionMember. + :type: int + """ + self._member_order = member_order + + @property + def member_id(self): + """ + **[Required]** Gets the member_id of this ExecutionActionMember. + The `OCID`__ of the parent resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The member_id of this ExecutionActionMember. + :rtype: str + """ + return self._member_id + + @member_id.setter + def member_id(self, member_id): + """ + Sets the member_id of this ExecutionActionMember. + The `OCID`__ of the parent resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param member_id: The member_id of this ExecutionActionMember. + :type: str + """ + self._member_id = member_id + + @property + def status(self): + """ + Gets the status of this ExecutionActionMember. + The current status of the execution action member. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, DURATION_EXCEEDED, RESCHEDULED and COMPLETED. + enum: + - SCHEDULED + - IN_PROGRESS + - FAILED + - CANCELED + - DURATION_EXCEEDED + - RESCHEDULED + - SUCCEEDED + + + :return: The status of this ExecutionActionMember. + :rtype: str + """ + return self._status + + @status.setter + def status(self, status): + """ + Sets the status of this ExecutionActionMember. + The current status of the execution action member. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, DURATION_EXCEEDED, RESCHEDULED and COMPLETED. + enum: + - SCHEDULED + - IN_PROGRESS + - FAILED + - CANCELED + - DURATION_EXCEEDED + - RESCHEDULED + - SUCCEEDED + + + :param status: The status of this ExecutionActionMember. + :type: str + """ + self._status = status + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ExecutionActionMember. + The estimated time of the execution action member in minutes. + + + :return: The estimated_time_in_mins of this ExecutionActionMember. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ExecutionActionMember. + The estimated time of the execution action member in minutes. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ExecutionActionMember. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this ExecutionActionMember. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this ExecutionActionMember. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this ExecutionActionMember. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this ExecutionActionMember. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + + 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/execution_action_summary.py b/src/oci/database/models/execution_action_summary.py new file mode 100644 index 0000000000..3b2c156d54 --- /dev/null +++ b/src/oci/database/models/execution_action_summary.py @@ -0,0 +1,715 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ExecutionActionSummary(object): + """ + Details of an execution action. + """ + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "SCHEDULED" + LIFECYCLE_STATE_SCHEDULED = "SCHEDULED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "IN_PROGRESS" + LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "CANCELED" + LIFECYCLE_STATE_CANCELED = "CANCELED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "SUCCEEDED" + LIFECYCLE_STATE_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionActionSummary. + #: This constant has a value of "PARTIAL_SUCCESS" + LIFECYCLE_STATE_PARTIAL_SUCCESS = "PARTIAL_SUCCESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionActionSummary. + #: This constant has a value of "DURATION_EXCEEDED" + LIFECYCLE_SUBSTATE_DURATION_EXCEEDED = "DURATION_EXCEEDED" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionActionSummary. + #: This constant has a value of "MAINTENANCE_IN_PROGRESS" + LIFECYCLE_SUBSTATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionActionSummary. + #: This constant has a value of "WAITING" + LIFECYCLE_SUBSTATE_WAITING = "WAITING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionActionSummary. + #: This constant has a value of "RESCHEDULED" + LIFECYCLE_SUBSTATE_RESCHEDULED = "RESCHEDULED" + + #: A constant which can be used with the action_type property of a ExecutionActionSummary. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ExecutionActionSummary. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ExecutionActionSummary. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + def __init__(self, **kwargs): + """ + Initializes a new ExecutionActionSummary 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 ExecutionActionSummary. + :type id: str + + :param execution_window_id: + The value to assign to the execution_window_id property of this ExecutionActionSummary. + :type execution_window_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExecutionActionSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this ExecutionActionSummary. + :type display_name: str + + :param description: + The value to assign to the description property of this ExecutionActionSummary. + :type description: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExecutionActionSummary. + Allowed values for this property are: "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_substate: + The value to assign to the lifecycle_substate property of this ExecutionActionSummary. + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_substate: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExecutionActionSummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExecutionActionSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ExecutionActionSummary. + :type time_updated: datetime + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ExecutionActionSummary. + :type estimated_time_in_mins: int + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this ExecutionActionSummary. + :type total_time_taken_in_mins: int + + :param execution_action_order: + The value to assign to the execution_action_order property of this ExecutionActionSummary. + :type execution_action_order: int + + :param action_type: + The value to assign to the action_type property of this ExecutionActionSummary. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param action_params: + The value to assign to the action_params property of this ExecutionActionSummary. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this ExecutionActionSummary. + :type action_members: list[oci.database.models.ExecutionActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExecutionActionSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExecutionActionSummary. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'execution_window_id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'lifecycle_state': 'str', + 'lifecycle_substate': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'estimated_time_in_mins': 'int', + 'total_time_taken_in_mins': 'int', + 'execution_action_order': 'int', + 'action_type': 'str', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ExecutionActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'execution_window_id': 'executionWindowId', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_substate': 'lifecycleSubstate', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', + 'execution_action_order': 'executionActionOrder', + 'action_type': 'actionType', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._execution_window_id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._lifecycle_state = None + self._lifecycle_substate = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._estimated_time_in_mins = None + self._total_time_taken_in_mins = None + self._execution_action_order = None + self._action_type = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ExecutionActionSummary. + The `OCID`__ of the execution action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExecutionActionSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExecutionActionSummary. + The `OCID`__ of the execution action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExecutionActionSummary. + :type: str + """ + self._id = id + + @property + def execution_window_id(self): + """ + **[Required]** Gets the execution_window_id of this ExecutionActionSummary. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_window_id of this ExecutionActionSummary. + :rtype: str + """ + return self._execution_window_id + + @execution_window_id.setter + def execution_window_id(self, execution_window_id): + """ + Sets the execution_window_id of this ExecutionActionSummary. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_window_id: The execution_window_id of this ExecutionActionSummary. + :type: str + """ + self._execution_window_id = execution_window_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExecutionActionSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExecutionActionSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExecutionActionSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExecutionActionSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExecutionActionSummary. + The user-friendly name for the execution action. The name does not need to be unique. + + + :return: The display_name of this ExecutionActionSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExecutionActionSummary. + The user-friendly name for the execution action. The name does not need to be unique. + + + :param display_name: The display_name of this ExecutionActionSummary. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this ExecutionActionSummary. + Description of the execution action. + + + :return: The description of this ExecutionActionSummary. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ExecutionActionSummary. + Description of the execution action. + + + :param description: The description of this ExecutionActionSummary. + :type: str + """ + self._description = description + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExecutionActionSummary. + The current state of the execution action. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + Allowed values for this property are: "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExecutionActionSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExecutionActionSummary. + The current state of the execution action. Valid states are SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + + :param lifecycle_state: The lifecycle_state of this ExecutionActionSummary. + :type: str + """ + allowed_values = ["SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS"] + 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_substate(self): + """ + Gets the lifecycle_substate of this ExecutionActionSummary. + The current sub-state of the execution action. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_substate of this ExecutionActionSummary. + :rtype: str + """ + return self._lifecycle_substate + + @lifecycle_substate.setter + def lifecycle_substate(self, lifecycle_substate): + """ + Sets the lifecycle_substate of this ExecutionActionSummary. + The current sub-state of the execution action. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + + :param lifecycle_substate: The lifecycle_substate of this ExecutionActionSummary. + :type: str + """ + allowed_values = ["DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED"] + if not value_allowed_none_or_none_sentinel(lifecycle_substate, allowed_values): + lifecycle_substate = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_substate = lifecycle_substate + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExecutionActionSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExecutionActionSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExecutionActionSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExecutionActionSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this ExecutionActionSummary. + The date and time the execution action was created. + + + :return: The time_created of this ExecutionActionSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExecutionActionSummary. + The date and time the execution action was created. + + + :param time_created: The time_created of this ExecutionActionSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ExecutionActionSummary. + The last date and time that the execution action was updated. + + + :return: The time_updated of this ExecutionActionSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ExecutionActionSummary. + The last date and time that the execution action was updated. + + + :param time_updated: The time_updated of this ExecutionActionSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ExecutionActionSummary. + The estimated time of the execution action in minutes. + + + :return: The estimated_time_in_mins of this ExecutionActionSummary. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ExecutionActionSummary. + The estimated time of the execution action in minutes. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ExecutionActionSummary. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this ExecutionActionSummary. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this ExecutionActionSummary. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this ExecutionActionSummary. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this ExecutionActionSummary. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + + @property + def execution_action_order(self): + """ + Gets the execution_action_order of this ExecutionActionSummary. + The priority order of the execution action. + + + :return: The execution_action_order of this ExecutionActionSummary. + :rtype: int + """ + return self._execution_action_order + + @execution_action_order.setter + def execution_action_order(self, execution_action_order): + """ + Sets the execution_action_order of this ExecutionActionSummary. + The priority order of the execution action. + + + :param execution_action_order: The execution_action_order of this ExecutionActionSummary. + :type: int + """ + self._execution_action_order = execution_action_order + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this ExecutionActionSummary. + The action type of the execution action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this ExecutionActionSummary. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this ExecutionActionSummary. + The action type of the execution action being performed + + + :param action_type: The action_type of this ExecutionActionSummary. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def action_params(self): + """ + **[Required]** Gets the action_params of this ExecutionActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this ExecutionActionSummary. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this ExecutionActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this ExecutionActionSummary. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this ExecutionActionSummary. + List of action members of this execution action. + + + :return: The action_members of this ExecutionActionSummary. + :rtype: list[oci.database.models.ExecutionActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this ExecutionActionSummary. + List of action members of this execution action. + + + :param action_members: The action_members of this ExecutionActionSummary. + :type: list[oci.database.models.ExecutionActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExecutionActionSummary. + 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 ExecutionActionSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExecutionActionSummary. + 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 ExecutionActionSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExecutionActionSummary. + 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 ExecutionActionSummary. + :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 ExecutionActionSummary. + 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 ExecutionActionSummary. + :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/execution_window.py b/src/oci/database/models/execution_window.py new file mode 100644 index 0000000000..fdac22f5b7 --- /dev/null +++ b/src/oci/database/models/execution_window.py @@ -0,0 +1,783 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ExecutionWindow(object): + """ + Details of an execution window. + """ + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "CREATED" + LIFECYCLE_STATE_CREATED = "CREATED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "SCHEDULED" + LIFECYCLE_STATE_SCHEDULED = "SCHEDULED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "IN_PROGRESS" + LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "CANCELED" + LIFECYCLE_STATE_CANCELED = "CANCELED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "SUCCEEDED" + LIFECYCLE_STATE_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "PARTIAL_SUCCESS" + LIFECYCLE_STATE_PARTIAL_SUCCESS = "PARTIAL_SUCCESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindow. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindow. + #: This constant has a value of "DURATION_EXCEEDED" + LIFECYCLE_SUBSTATE_DURATION_EXCEEDED = "DURATION_EXCEEDED" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindow. + #: This constant has a value of "MAINTENANCE_IN_PROGRESS" + LIFECYCLE_SUBSTATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindow. + #: This constant has a value of "WAITING" + LIFECYCLE_SUBSTATE_WAITING = "WAITING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindow. + #: This constant has a value of "RESCHEDULED" + LIFECYCLE_SUBSTATE_RESCHEDULED = "RESCHEDULED" + + #: A constant which can be used with the window_type property of a ExecutionWindow. + #: This constant has a value of "PLANNED" + WINDOW_TYPE_PLANNED = "PLANNED" + + #: A constant which can be used with the window_type property of a ExecutionWindow. + #: This constant has a value of "UNPLANNED" + WINDOW_TYPE_UNPLANNED = "UNPLANNED" + + def __init__(self, **kwargs): + """ + Initializes a new ExecutionWindow 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 ExecutionWindow. + :type id: str + + :param execution_resource_id: + The value to assign to the execution_resource_id property of this ExecutionWindow. + :type execution_resource_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExecutionWindow. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this ExecutionWindow. + :type display_name: str + + :param description: + The value to assign to the description property of this ExecutionWindow. + :type description: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExecutionWindow. + Allowed values for this property are: "CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_substate: + The value to assign to the lifecycle_substate property of this ExecutionWindow. + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_substate: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExecutionWindow. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExecutionWindow. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ExecutionWindow. + :type time_updated: datetime + + :param time_started: + The value to assign to the time_started property of this ExecutionWindow. + :type time_started: datetime + + :param time_ended: + The value to assign to the time_ended property of this ExecutionWindow. + :type time_ended: datetime + + :param time_scheduled: + The value to assign to the time_scheduled property of this ExecutionWindow. + :type time_scheduled: datetime + + :param window_duration_in_mins: + The value to assign to the window_duration_in_mins property of this ExecutionWindow. + :type window_duration_in_mins: int + + :param is_enforced_duration: + The value to assign to the is_enforced_duration property of this ExecutionWindow. + :type is_enforced_duration: bool + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ExecutionWindow. + :type estimated_time_in_mins: int + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this ExecutionWindow. + :type total_time_taken_in_mins: int + + :param window_type: + The value to assign to the window_type property of this ExecutionWindow. + Allowed values for this property are: "PLANNED", "UNPLANNED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type window_type: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExecutionWindow. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExecutionWindow. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'execution_resource_id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'lifecycle_state': 'str', + 'lifecycle_substate': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'time_started': 'datetime', + 'time_ended': 'datetime', + 'time_scheduled': 'datetime', + 'window_duration_in_mins': 'int', + 'is_enforced_duration': 'bool', + 'estimated_time_in_mins': 'int', + 'total_time_taken_in_mins': 'int', + 'window_type': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'execution_resource_id': 'executionResourceId', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_substate': 'lifecycleSubstate', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'time_started': 'timeStarted', + 'time_ended': 'timeEnded', + 'time_scheduled': 'timeScheduled', + 'window_duration_in_mins': 'windowDurationInMins', + 'is_enforced_duration': 'isEnforcedDuration', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', + 'window_type': 'windowType', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._execution_resource_id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._lifecycle_state = None + self._lifecycle_substate = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._time_started = None + self._time_ended = None + self._time_scheduled = None + self._window_duration_in_mins = None + self._is_enforced_duration = None + self._estimated_time_in_mins = None + self._total_time_taken_in_mins = None + self._window_type = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ExecutionWindow. + The `OCID`__ of the execution window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExecutionWindow. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExecutionWindow. + The `OCID`__ of the execution window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExecutionWindow. + :type: str + """ + self._id = id + + @property + def execution_resource_id(self): + """ + **[Required]** Gets the execution_resource_id of this ExecutionWindow. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_resource_id of this ExecutionWindow. + :rtype: str + """ + return self._execution_resource_id + + @execution_resource_id.setter + def execution_resource_id(self, execution_resource_id): + """ + Sets the execution_resource_id of this ExecutionWindow. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_resource_id: The execution_resource_id of this ExecutionWindow. + :type: str + """ + self._execution_resource_id = execution_resource_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExecutionWindow. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExecutionWindow. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExecutionWindow. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExecutionWindow. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExecutionWindow. + The user-friendly name for the execution window. The name does not need to be unique. + + + :return: The display_name of this ExecutionWindow. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExecutionWindow. + The user-friendly name for the execution window. The name does not need to be unique. + + + :param display_name: The display_name of this ExecutionWindow. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this ExecutionWindow. + Description of the execution window. + + + :return: The description of this ExecutionWindow. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ExecutionWindow. + Description of the execution window. + + + :param description: The description of this ExecutionWindow. + :type: str + """ + self._description = description + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExecutionWindow. + The current state of the Schedule Policy. Valid states are CREATED, SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + Allowed values for this property are: "CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExecutionWindow. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExecutionWindow. + The current state of the Schedule Policy. Valid states are CREATED, SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + + :param lifecycle_state: The lifecycle_state of this ExecutionWindow. + :type: str + """ + allowed_values = ["CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING"] + 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_substate(self): + """ + Gets the lifecycle_substate of this ExecutionWindow. + The current sub-state of the execution window. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_substate of this ExecutionWindow. + :rtype: str + """ + return self._lifecycle_substate + + @lifecycle_substate.setter + def lifecycle_substate(self, lifecycle_substate): + """ + Sets the lifecycle_substate of this ExecutionWindow. + The current sub-state of the execution window. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + + :param lifecycle_substate: The lifecycle_substate of this ExecutionWindow. + :type: str + """ + allowed_values = ["DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED"] + if not value_allowed_none_or_none_sentinel(lifecycle_substate, allowed_values): + lifecycle_substate = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_substate = lifecycle_substate + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExecutionWindow. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExecutionWindow. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExecutionWindow. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExecutionWindow. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this ExecutionWindow. + The date and time the execution window was created. + + + :return: The time_created of this ExecutionWindow. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExecutionWindow. + The date and time the execution window was created. + + + :param time_created: The time_created of this ExecutionWindow. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ExecutionWindow. + The last date and time that the execution window was updated. + + + :return: The time_updated of this ExecutionWindow. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ExecutionWindow. + The last date and time that the execution window was updated. + + + :param time_updated: The time_updated of this ExecutionWindow. + :type: datetime + """ + self._time_updated = time_updated + + @property + def time_started(self): + """ + Gets the time_started of this ExecutionWindow. + The date and time that the execution window was started. + + + :return: The time_started of this ExecutionWindow. + :rtype: datetime + """ + return self._time_started + + @time_started.setter + def time_started(self, time_started): + """ + Sets the time_started of this ExecutionWindow. + The date and time that the execution window was started. + + + :param time_started: The time_started of this ExecutionWindow. + :type: datetime + """ + self._time_started = time_started + + @property + def time_ended(self): + """ + Gets the time_ended of this ExecutionWindow. + The date and time that the execution window ended. + + + :return: The time_ended of this ExecutionWindow. + :rtype: datetime + """ + return self._time_ended + + @time_ended.setter + def time_ended(self, time_ended): + """ + Sets the time_ended of this ExecutionWindow. + The date and time that the execution window ended. + + + :param time_ended: The time_ended of this ExecutionWindow. + :type: datetime + """ + self._time_ended = time_ended + + @property + def time_scheduled(self): + """ + **[Required]** Gets the time_scheduled of this ExecutionWindow. + The scheduled start date and time of the execution window. + + + :return: The time_scheduled of this ExecutionWindow. + :rtype: datetime + """ + return self._time_scheduled + + @time_scheduled.setter + def time_scheduled(self, time_scheduled): + """ + Sets the time_scheduled of this ExecutionWindow. + The scheduled start date and time of the execution window. + + + :param time_scheduled: The time_scheduled of this ExecutionWindow. + :type: datetime + """ + self._time_scheduled = time_scheduled + + @property + def window_duration_in_mins(self): + """ + **[Required]** Gets the window_duration_in_mins of this ExecutionWindow. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The window_duration_in_mins of this ExecutionWindow. + :rtype: int + """ + return self._window_duration_in_mins + + @window_duration_in_mins.setter + def window_duration_in_mins(self, window_duration_in_mins): + """ + Sets the window_duration_in_mins of this ExecutionWindow. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param window_duration_in_mins: The window_duration_in_mins of this ExecutionWindow. + :type: int + """ + self._window_duration_in_mins = window_duration_in_mins + + @property + def is_enforced_duration(self): + """ + Gets the is_enforced_duration of this ExecutionWindow. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration of this ExecutionWindow. + :rtype: bool + """ + return self._is_enforced_duration + + @is_enforced_duration.setter + def is_enforced_duration(self, is_enforced_duration): + """ + Sets the is_enforced_duration of this ExecutionWindow. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration: The is_enforced_duration of this ExecutionWindow. + :type: bool + """ + self._is_enforced_duration = is_enforced_duration + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ExecutionWindow. + The estimated time of the execution window in minutes. + + + :return: The estimated_time_in_mins of this ExecutionWindow. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ExecutionWindow. + The estimated time of the execution window in minutes. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ExecutionWindow. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this ExecutionWindow. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this ExecutionWindow. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this ExecutionWindow. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this ExecutionWindow. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + + @property + def window_type(self): + """ + Gets the window_type of this ExecutionWindow. + The execution window is of PLANNED or UNPLANNED type. + + Allowed values for this property are: "PLANNED", "UNPLANNED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The window_type of this ExecutionWindow. + :rtype: str + """ + return self._window_type + + @window_type.setter + def window_type(self, window_type): + """ + Sets the window_type of this ExecutionWindow. + The execution window is of PLANNED or UNPLANNED type. + + + :param window_type: The window_type of this ExecutionWindow. + :type: str + """ + allowed_values = ["PLANNED", "UNPLANNED"] + if not value_allowed_none_or_none_sentinel(window_type, allowed_values): + window_type = 'UNKNOWN_ENUM_VALUE' + self._window_type = window_type + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExecutionWindow. + 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 ExecutionWindow. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExecutionWindow. + 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 ExecutionWindow. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExecutionWindow. + 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 ExecutionWindow. + :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 ExecutionWindow. + 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 ExecutionWindow. + :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/execution_window_summary.py b/src/oci/database/models/execution_window_summary.py new file mode 100644 index 0000000000..cf25ffae47 --- /dev/null +++ b/src/oci/database/models/execution_window_summary.py @@ -0,0 +1,783 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ExecutionWindowSummary(object): + """ + Details of an execution window. + """ + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "CREATED" + LIFECYCLE_STATE_CREATED = "CREATED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "SCHEDULED" + LIFECYCLE_STATE_SCHEDULED = "SCHEDULED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "IN_PROGRESS" + LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "CANCELED" + LIFECYCLE_STATE_CANCELED = "CANCELED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "SUCCEEDED" + LIFECYCLE_STATE_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "PARTIAL_SUCCESS" + LIFECYCLE_STATE_PARTIAL_SUCCESS = "PARTIAL_SUCCESS" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a ExecutionWindowSummary. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindowSummary. + #: This constant has a value of "DURATION_EXCEEDED" + LIFECYCLE_SUBSTATE_DURATION_EXCEEDED = "DURATION_EXCEEDED" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindowSummary. + #: This constant has a value of "MAINTENANCE_IN_PROGRESS" + LIFECYCLE_SUBSTATE_MAINTENANCE_IN_PROGRESS = "MAINTENANCE_IN_PROGRESS" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindowSummary. + #: This constant has a value of "WAITING" + LIFECYCLE_SUBSTATE_WAITING = "WAITING" + + #: A constant which can be used with the lifecycle_substate property of a ExecutionWindowSummary. + #: This constant has a value of "RESCHEDULED" + LIFECYCLE_SUBSTATE_RESCHEDULED = "RESCHEDULED" + + #: A constant which can be used with the window_type property of a ExecutionWindowSummary. + #: This constant has a value of "PLANNED" + WINDOW_TYPE_PLANNED = "PLANNED" + + #: A constant which can be used with the window_type property of a ExecutionWindowSummary. + #: This constant has a value of "UNPLANNED" + WINDOW_TYPE_UNPLANNED = "UNPLANNED" + + def __init__(self, **kwargs): + """ + Initializes a new ExecutionWindowSummary 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 ExecutionWindowSummary. + :type id: str + + :param execution_resource_id: + The value to assign to the execution_resource_id property of this ExecutionWindowSummary. + :type execution_resource_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ExecutionWindowSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this ExecutionWindowSummary. + :type display_name: str + + :param description: + The value to assign to the description property of this ExecutionWindowSummary. + :type description: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ExecutionWindowSummary. + Allowed values for this property are: "CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_substate: + The value to assign to the lifecycle_substate property of this ExecutionWindowSummary. + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_substate: str + + :param lifecycle_details: + The value to assign to the lifecycle_details property of this ExecutionWindowSummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this ExecutionWindowSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ExecutionWindowSummary. + :type time_updated: datetime + + :param time_started: + The value to assign to the time_started property of this ExecutionWindowSummary. + :type time_started: datetime + + :param time_ended: + The value to assign to the time_ended property of this ExecutionWindowSummary. + :type time_ended: datetime + + :param time_scheduled: + The value to assign to the time_scheduled property of this ExecutionWindowSummary. + :type time_scheduled: datetime + + :param window_duration_in_mins: + The value to assign to the window_duration_in_mins property of this ExecutionWindowSummary. + :type window_duration_in_mins: int + + :param is_enforced_duration: + The value to assign to the is_enforced_duration property of this ExecutionWindowSummary. + :type is_enforced_duration: bool + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ExecutionWindowSummary. + :type estimated_time_in_mins: int + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this ExecutionWindowSummary. + :type total_time_taken_in_mins: int + + :param window_type: + The value to assign to the window_type property of this ExecutionWindowSummary. + Allowed values for this property are: "PLANNED", "UNPLANNED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type window_type: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this ExecutionWindowSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ExecutionWindowSummary. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'execution_resource_id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'lifecycle_state': 'str', + 'lifecycle_substate': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'time_started': 'datetime', + 'time_ended': 'datetime', + 'time_scheduled': 'datetime', + 'window_duration_in_mins': 'int', + 'is_enforced_duration': 'bool', + 'estimated_time_in_mins': 'int', + 'total_time_taken_in_mins': 'int', + 'window_type': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'execution_resource_id': 'executionResourceId', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_substate': 'lifecycleSubstate', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'time_started': 'timeStarted', + 'time_ended': 'timeEnded', + 'time_scheduled': 'timeScheduled', + 'window_duration_in_mins': 'windowDurationInMins', + 'is_enforced_duration': 'isEnforcedDuration', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', + 'window_type': 'windowType', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._execution_resource_id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._lifecycle_state = None + self._lifecycle_substate = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._time_started = None + self._time_ended = None + self._time_scheduled = None + self._window_duration_in_mins = None + self._is_enforced_duration = None + self._estimated_time_in_mins = None + self._total_time_taken_in_mins = None + self._window_type = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ExecutionWindowSummary. + The `OCID`__ of the execution window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ExecutionWindowSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ExecutionWindowSummary. + The `OCID`__ of the execution window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ExecutionWindowSummary. + :type: str + """ + self._id = id + + @property + def execution_resource_id(self): + """ + **[Required]** Gets the execution_resource_id of this ExecutionWindowSummary. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_resource_id of this ExecutionWindowSummary. + :rtype: str + """ + return self._execution_resource_id + + @execution_resource_id.setter + def execution_resource_id(self, execution_resource_id): + """ + Sets the execution_resource_id of this ExecutionWindowSummary. + The `OCID`__ of the execution resource the execution window belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_resource_id: The execution_resource_id of this ExecutionWindowSummary. + :type: str + """ + self._execution_resource_id = execution_resource_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ExecutionWindowSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ExecutionWindowSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ExecutionWindowSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ExecutionWindowSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ExecutionWindowSummary. + The user-friendly name for the execution window. The name does not need to be unique. + + + :return: The display_name of this ExecutionWindowSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ExecutionWindowSummary. + The user-friendly name for the execution window. The name does not need to be unique. + + + :param display_name: The display_name of this ExecutionWindowSummary. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this ExecutionWindowSummary. + Description of the execution window. + + + :return: The description of this ExecutionWindowSummary. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ExecutionWindowSummary. + Description of the execution window. + + + :param description: The description of this ExecutionWindowSummary. + :type: str + """ + self._description = description + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ExecutionWindowSummary. + The current state of the Schedule Policy. Valid states are CREATED, SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + Allowed values for this property are: "CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ExecutionWindowSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ExecutionWindowSummary. + The current state of the Schedule Policy. Valid states are CREATED, SCHEDULED, IN_PROGRESS, FAILED, CANCELED, + UPDATING, DELETED, SUCCEEDED and PARTIAL_SUCCESS. + + + :param lifecycle_state: The lifecycle_state of this ExecutionWindowSummary. + :type: str + """ + allowed_values = ["CREATED", "SCHEDULED", "IN_PROGRESS", "FAILED", "CANCELED", "UPDATING", "DELETED", "SUCCEEDED", "PARTIAL_SUCCESS", "CREATING", "DELETING"] + 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_substate(self): + """ + Gets the lifecycle_substate of this ExecutionWindowSummary. + The current sub-state of the execution window. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + Allowed values for this property are: "DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_substate of this ExecutionWindowSummary. + :rtype: str + """ + return self._lifecycle_substate + + @lifecycle_substate.setter + def lifecycle_substate(self, lifecycle_substate): + """ + Sets the lifecycle_substate of this ExecutionWindowSummary. + The current sub-state of the execution window. Valid states are DURATION_EXCEEDED, MAINTENANCE_IN_PROGRESS and WAITING. + + + :param lifecycle_substate: The lifecycle_substate of this ExecutionWindowSummary. + :type: str + """ + allowed_values = ["DURATION_EXCEEDED", "MAINTENANCE_IN_PROGRESS", "WAITING", "RESCHEDULED"] + if not value_allowed_none_or_none_sentinel(lifecycle_substate, allowed_values): + lifecycle_substate = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_substate = lifecycle_substate + + @property + def lifecycle_details(self): + """ + Gets the lifecycle_details of this ExecutionWindowSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this ExecutionWindowSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this ExecutionWindowSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this ExecutionWindowSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this ExecutionWindowSummary. + The date and time the execution window was created. + + + :return: The time_created of this ExecutionWindowSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ExecutionWindowSummary. + The date and time the execution window was created. + + + :param time_created: The time_created of this ExecutionWindowSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ExecutionWindowSummary. + The last date and time that the execution window was updated. + + + :return: The time_updated of this ExecutionWindowSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ExecutionWindowSummary. + The last date and time that the execution window was updated. + + + :param time_updated: The time_updated of this ExecutionWindowSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def time_started(self): + """ + Gets the time_started of this ExecutionWindowSummary. + The date and time that the execution window was started. + + + :return: The time_started of this ExecutionWindowSummary. + :rtype: datetime + """ + return self._time_started + + @time_started.setter + def time_started(self, time_started): + """ + Sets the time_started of this ExecutionWindowSummary. + The date and time that the execution window was started. + + + :param time_started: The time_started of this ExecutionWindowSummary. + :type: datetime + """ + self._time_started = time_started + + @property + def time_ended(self): + """ + Gets the time_ended of this ExecutionWindowSummary. + The date and time that the execution window ended. + + + :return: The time_ended of this ExecutionWindowSummary. + :rtype: datetime + """ + return self._time_ended + + @time_ended.setter + def time_ended(self, time_ended): + """ + Sets the time_ended of this ExecutionWindowSummary. + The date and time that the execution window ended. + + + :param time_ended: The time_ended of this ExecutionWindowSummary. + :type: datetime + """ + self._time_ended = time_ended + + @property + def time_scheduled(self): + """ + **[Required]** Gets the time_scheduled of this ExecutionWindowSummary. + The scheduled start date and time of the execution window. + + + :return: The time_scheduled of this ExecutionWindowSummary. + :rtype: datetime + """ + return self._time_scheduled + + @time_scheduled.setter + def time_scheduled(self, time_scheduled): + """ + Sets the time_scheduled of this ExecutionWindowSummary. + The scheduled start date and time of the execution window. + + + :param time_scheduled: The time_scheduled of this ExecutionWindowSummary. + :type: datetime + """ + self._time_scheduled = time_scheduled + + @property + def window_duration_in_mins(self): + """ + **[Required]** Gets the window_duration_in_mins of this ExecutionWindowSummary. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The window_duration_in_mins of this ExecutionWindowSummary. + :rtype: int + """ + return self._window_duration_in_mins + + @window_duration_in_mins.setter + def window_duration_in_mins(self, window_duration_in_mins): + """ + Sets the window_duration_in_mins of this ExecutionWindowSummary. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param window_duration_in_mins: The window_duration_in_mins of this ExecutionWindowSummary. + :type: int + """ + self._window_duration_in_mins = window_duration_in_mins + + @property + def is_enforced_duration(self): + """ + Gets the is_enforced_duration of this ExecutionWindowSummary. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration of this ExecutionWindowSummary. + :rtype: bool + """ + return self._is_enforced_duration + + @is_enforced_duration.setter + def is_enforced_duration(self, is_enforced_duration): + """ + Sets the is_enforced_duration of this ExecutionWindowSummary. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration: The is_enforced_duration of this ExecutionWindowSummary. + :type: bool + """ + self._is_enforced_duration = is_enforced_duration + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ExecutionWindowSummary. + The estimated time of the execution window in minutes. + + + :return: The estimated_time_in_mins of this ExecutionWindowSummary. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ExecutionWindowSummary. + The estimated time of the execution window in minutes. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ExecutionWindowSummary. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this ExecutionWindowSummary. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this ExecutionWindowSummary. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this ExecutionWindowSummary. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this ExecutionWindowSummary. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + + @property + def window_type(self): + """ + Gets the window_type of this ExecutionWindowSummary. + The execution window is of PLANNED or UNPLANNED type. + + Allowed values for this property are: "PLANNED", "UNPLANNED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The window_type of this ExecutionWindowSummary. + :rtype: str + """ + return self._window_type + + @window_type.setter + def window_type(self, window_type): + """ + Sets the window_type of this ExecutionWindowSummary. + The execution window is of PLANNED or UNPLANNED type. + + + :param window_type: The window_type of this ExecutionWindowSummary. + :type: str + """ + allowed_values = ["PLANNED", "UNPLANNED"] + if not value_allowed_none_or_none_sentinel(window_type, allowed_values): + window_type = 'UNKNOWN_ENUM_VALUE' + self._window_type = window_type + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ExecutionWindowSummary. + 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 ExecutionWindowSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ExecutionWindowSummary. + 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 ExecutionWindowSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ExecutionWindowSummary. + 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 ExecutionWindowSummary. + :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 ExecutionWindowSummary. + 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 ExecutionWindowSummary. + :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/granular_maintenance_history_details.py b/src/oci/database/models/granular_maintenance_history_details.py new file mode 100644 index 0000000000..0b09120af6 --- /dev/null +++ b/src/oci/database/models/granular_maintenance_history_details.py @@ -0,0 +1,99 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 GranularMaintenanceHistoryDetails(object): + """ + Details of a granular maintenance history. + """ + + def __init__(self, **kwargs): + """ + Initializes a new GranularMaintenanceHistoryDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param execution_window: + The value to assign to the execution_window property of this GranularMaintenanceHistoryDetails. + :type execution_window: oci.database.models.ExecutionWindow + + :param execution_actions: + The value to assign to the execution_actions property of this GranularMaintenanceHistoryDetails. + :type execution_actions: list[oci.database.models.ExecutionAction] + + """ + self.swagger_types = { + 'execution_window': 'ExecutionWindow', + 'execution_actions': 'list[ExecutionAction]' + } + + self.attribute_map = { + 'execution_window': 'executionWindow', + 'execution_actions': 'executionActions' + } + + self._execution_window = None + self._execution_actions = None + + @property + def execution_window(self): + """ + **[Required]** Gets the execution_window of this GranularMaintenanceHistoryDetails. + + :return: The execution_window of this GranularMaintenanceHistoryDetails. + :rtype: oci.database.models.ExecutionWindow + """ + return self._execution_window + + @execution_window.setter + def execution_window(self, execution_window): + """ + Sets the execution_window of this GranularMaintenanceHistoryDetails. + + :param execution_window: The execution_window of this GranularMaintenanceHistoryDetails. + :type: oci.database.models.ExecutionWindow + """ + self._execution_window = execution_window + + @property + def execution_actions(self): + """ + **[Required]** Gets the execution_actions of this GranularMaintenanceHistoryDetails. + The list of execution actions for this granular maintenance history. + + + :return: The execution_actions of this GranularMaintenanceHistoryDetails. + :rtype: list[oci.database.models.ExecutionAction] + """ + return self._execution_actions + + @execution_actions.setter + def execution_actions(self, execution_actions): + """ + Sets the execution_actions of this GranularMaintenanceHistoryDetails. + The list of execution actions for this granular maintenance history. + + + :param execution_actions: The execution_actions of this GranularMaintenanceHistoryDetails. + :type: list[oci.database.models.ExecutionAction] + """ + self._execution_actions = execution_actions + + 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 42316fd657..6d902c5923 100644 --- a/src/oci/database/models/maintenance_run.py +++ b/src/oci/database/models/maintenance_run.py @@ -280,6 +280,14 @@ def __init__(self, **kwargs): The value to assign to the estimated_component_patching_start_time property of this MaintenanceRun. :type estimated_component_patching_start_time: datetime + :param is_maintenance_run_granular: + The value to assign to the is_maintenance_run_granular property of this MaintenanceRun. + :type is_maintenance_run_granular: bool + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this MaintenanceRun. + :type total_time_taken_in_mins: int + :param database_software_image_id: The value to assign to the database_software_image_id property of this MaintenanceRun. :type database_software_image_id: str @@ -315,6 +323,8 @@ def __init__(self, **kwargs): 'estimated_patching_time': 'EstimatedPatchingTime', 'current_patching_component': 'str', 'estimated_component_patching_start_time': 'datetime', + 'is_maintenance_run_granular': 'bool', + 'total_time_taken_in_mins': 'int', 'database_software_image_id': 'str' } @@ -348,6 +358,8 @@ def __init__(self, **kwargs): 'estimated_patching_time': 'estimatedPatchingTime', 'current_patching_component': 'currentPatchingComponent', 'estimated_component_patching_start_time': 'estimatedComponentPatchingStartTime', + 'is_maintenance_run_granular': 'isMaintenanceRunGranular', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', 'database_software_image_id': 'databaseSoftwareImageId' } @@ -380,6 +392,8 @@ def __init__(self, **kwargs): self._estimated_patching_time = None self._current_patching_component = None self._estimated_component_patching_start_time = None + self._is_maintenance_run_granular = None + self._total_time_taken_in_mins = None self._database_software_image_id = None @property @@ -1124,6 +1138,54 @@ def estimated_component_patching_start_time(self, estimated_component_patching_s """ self._estimated_component_patching_start_time = estimated_component_patching_start_time + @property + def is_maintenance_run_granular(self): + """ + Gets the is_maintenance_run_granular of this MaintenanceRun. + If `FALSE`, the maintenance run doesn't support granular maintenance. + + + :return: The is_maintenance_run_granular of this MaintenanceRun. + :rtype: bool + """ + return self._is_maintenance_run_granular + + @is_maintenance_run_granular.setter + def is_maintenance_run_granular(self, is_maintenance_run_granular): + """ + Sets the is_maintenance_run_granular of this MaintenanceRun. + If `FALSE`, the maintenance run doesn't support granular maintenance. + + + :param is_maintenance_run_granular: The is_maintenance_run_granular of this MaintenanceRun. + :type: bool + """ + self._is_maintenance_run_granular = is_maintenance_run_granular + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this MaintenanceRun. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this MaintenanceRun. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this MaintenanceRun. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this MaintenanceRun. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + @property def database_software_image_id(self): """ diff --git a/src/oci/database/models/maintenance_run_history.py b/src/oci/database/models/maintenance_run_history.py index 6538304d4f..169095651c 100644 --- a/src/oci/database/models/maintenance_run_history.py +++ b/src/oci/database/models/maintenance_run_history.py @@ -32,22 +32,36 @@ def __init__(self, **kwargs): The value to assign to the db_servers_history_details property of this MaintenanceRunHistory. :type db_servers_history_details: list[oci.database.models.DbServerHistorySummary] + :param current_execution_window: + The value to assign to the current_execution_window property of this MaintenanceRunHistory. + :type current_execution_window: str + + :param granular_maintenance_history: + The value to assign to the granular_maintenance_history property of this MaintenanceRunHistory. + :type granular_maintenance_history: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ self.swagger_types = { 'id': 'str', 'maintenance_run_details': 'MaintenanceRunSummary', - 'db_servers_history_details': 'list[DbServerHistorySummary]' + 'db_servers_history_details': 'list[DbServerHistorySummary]', + 'current_execution_window': 'str', + 'granular_maintenance_history': 'list[GranularMaintenanceHistoryDetails]' } self.attribute_map = { 'id': 'id', 'maintenance_run_details': 'maintenanceRunDetails', - 'db_servers_history_details': 'dbServersHistoryDetails' + 'db_servers_history_details': 'dbServersHistoryDetails', + 'current_execution_window': 'currentExecutionWindow', + 'granular_maintenance_history': 'granularMaintenanceHistory' } self._id = None self._maintenance_run_details = None self._db_servers_history_details = None + self._current_execution_window = None + self._granular_maintenance_history = None @property def id(self): @@ -117,6 +131,54 @@ def db_servers_history_details(self, db_servers_history_details): """ self._db_servers_history_details = db_servers_history_details + @property + def current_execution_window(self): + """ + Gets the current_execution_window of this MaintenanceRunHistory. + The OCID of the current execution window. + + + :return: The current_execution_window of this MaintenanceRunHistory. + :rtype: str + """ + return self._current_execution_window + + @current_execution_window.setter + def current_execution_window(self, current_execution_window): + """ + Sets the current_execution_window of this MaintenanceRunHistory. + The OCID of the current execution window. + + + :param current_execution_window: The current_execution_window of this MaintenanceRunHistory. + :type: str + """ + self._current_execution_window = current_execution_window + + @property + def granular_maintenance_history(self): + """ + Gets the granular_maintenance_history of this MaintenanceRunHistory. + The list of granular maintenance history details. + + + :return: The granular_maintenance_history of this MaintenanceRunHistory. + :rtype: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ + return self._granular_maintenance_history + + @granular_maintenance_history.setter + def granular_maintenance_history(self, granular_maintenance_history): + """ + Sets the granular_maintenance_history of this MaintenanceRunHistory. + The list of granular maintenance history details. + + + :param granular_maintenance_history: The granular_maintenance_history of this MaintenanceRunHistory. + :type: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ + self._granular_maintenance_history = granular_maintenance_history + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/maintenance_run_history_summary.py b/src/oci/database/models/maintenance_run_history_summary.py index 0f095f6c63..2568c2714a 100644 --- a/src/oci/database/models/maintenance_run_history_summary.py +++ b/src/oci/database/models/maintenance_run_history_summary.py @@ -32,22 +32,36 @@ def __init__(self, **kwargs): The value to assign to the db_servers_history_details property of this MaintenanceRunHistorySummary. :type db_servers_history_details: list[oci.database.models.DbServerHistorySummary] + :param current_execution_window: + The value to assign to the current_execution_window property of this MaintenanceRunHistorySummary. + :type current_execution_window: str + + :param granular_maintenance_history: + The value to assign to the granular_maintenance_history property of this MaintenanceRunHistorySummary. + :type granular_maintenance_history: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ self.swagger_types = { 'id': 'str', 'maintenance_run_details': 'MaintenanceRunSummary', - 'db_servers_history_details': 'list[DbServerHistorySummary]' + 'db_servers_history_details': 'list[DbServerHistorySummary]', + 'current_execution_window': 'str', + 'granular_maintenance_history': 'list[GranularMaintenanceHistoryDetails]' } self.attribute_map = { 'id': 'id', 'maintenance_run_details': 'maintenanceRunDetails', - 'db_servers_history_details': 'dbServersHistoryDetails' + 'db_servers_history_details': 'dbServersHistoryDetails', + 'current_execution_window': 'currentExecutionWindow', + 'granular_maintenance_history': 'granularMaintenanceHistory' } self._id = None self._maintenance_run_details = None self._db_servers_history_details = None + self._current_execution_window = None + self._granular_maintenance_history = None @property def id(self): @@ -117,6 +131,54 @@ def db_servers_history_details(self, db_servers_history_details): """ self._db_servers_history_details = db_servers_history_details + @property + def current_execution_window(self): + """ + Gets the current_execution_window of this MaintenanceRunHistorySummary. + The OCID of the current execution window. + + + :return: The current_execution_window of this MaintenanceRunHistorySummary. + :rtype: str + """ + return self._current_execution_window + + @current_execution_window.setter + def current_execution_window(self, current_execution_window): + """ + Sets the current_execution_window of this MaintenanceRunHistorySummary. + The OCID of the current execution window. + + + :param current_execution_window: The current_execution_window of this MaintenanceRunHistorySummary. + :type: str + """ + self._current_execution_window = current_execution_window + + @property + def granular_maintenance_history(self): + """ + Gets the granular_maintenance_history of this MaintenanceRunHistorySummary. + The list of granular maintenance history details. + + + :return: The granular_maintenance_history of this MaintenanceRunHistorySummary. + :rtype: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ + return self._granular_maintenance_history + + @granular_maintenance_history.setter + def granular_maintenance_history(self, granular_maintenance_history): + """ + Sets the granular_maintenance_history of this MaintenanceRunHistorySummary. + The list of granular maintenance history details. + + + :param granular_maintenance_history: The granular_maintenance_history of this MaintenanceRunHistorySummary. + :type: list[oci.database.models.GranularMaintenanceHistoryDetails] + """ + self._granular_maintenance_history = granular_maintenance_history + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/database/models/maintenance_run_summary.py b/src/oci/database/models/maintenance_run_summary.py index 51a260da52..8526cd2094 100644 --- a/src/oci/database/models/maintenance_run_summary.py +++ b/src/oci/database/models/maintenance_run_summary.py @@ -280,6 +280,14 @@ def __init__(self, **kwargs): The value to assign to the estimated_component_patching_start_time property of this MaintenanceRunSummary. :type estimated_component_patching_start_time: datetime + :param is_maintenance_run_granular: + The value to assign to the is_maintenance_run_granular property of this MaintenanceRunSummary. + :type is_maintenance_run_granular: bool + + :param total_time_taken_in_mins: + The value to assign to the total_time_taken_in_mins property of this MaintenanceRunSummary. + :type total_time_taken_in_mins: int + :param database_software_image_id: The value to assign to the database_software_image_id property of this MaintenanceRunSummary. :type database_software_image_id: str @@ -315,6 +323,8 @@ def __init__(self, **kwargs): 'estimated_patching_time': 'EstimatedPatchingTime', 'current_patching_component': 'str', 'estimated_component_patching_start_time': 'datetime', + 'is_maintenance_run_granular': 'bool', + 'total_time_taken_in_mins': 'int', 'database_software_image_id': 'str' } @@ -348,6 +358,8 @@ def __init__(self, **kwargs): 'estimated_patching_time': 'estimatedPatchingTime', 'current_patching_component': 'currentPatchingComponent', 'estimated_component_patching_start_time': 'estimatedComponentPatchingStartTime', + 'is_maintenance_run_granular': 'isMaintenanceRunGranular', + 'total_time_taken_in_mins': 'totalTimeTakenInMins', 'database_software_image_id': 'databaseSoftwareImageId' } @@ -380,6 +392,8 @@ def __init__(self, **kwargs): self._estimated_patching_time = None self._current_patching_component = None self._estimated_component_patching_start_time = None + self._is_maintenance_run_granular = None + self._total_time_taken_in_mins = None self._database_software_image_id = None @property @@ -1124,6 +1138,54 @@ def estimated_component_patching_start_time(self, estimated_component_patching_s """ self._estimated_component_patching_start_time = estimated_component_patching_start_time + @property + def is_maintenance_run_granular(self): + """ + Gets the is_maintenance_run_granular of this MaintenanceRunSummary. + If `FALSE`, the maintenance run doesn't support granular maintenance. + + + :return: The is_maintenance_run_granular of this MaintenanceRunSummary. + :rtype: bool + """ + return self._is_maintenance_run_granular + + @is_maintenance_run_granular.setter + def is_maintenance_run_granular(self, is_maintenance_run_granular): + """ + Sets the is_maintenance_run_granular of this MaintenanceRunSummary. + If `FALSE`, the maintenance run doesn't support granular maintenance. + + + :param is_maintenance_run_granular: The is_maintenance_run_granular of this MaintenanceRunSummary. + :type: bool + """ + self._is_maintenance_run_granular = is_maintenance_run_granular + + @property + def total_time_taken_in_mins(self): + """ + Gets the total_time_taken_in_mins of this MaintenanceRunSummary. + The total time taken by corresponding resource activity in minutes. + + + :return: The total_time_taken_in_mins of this MaintenanceRunSummary. + :rtype: int + """ + return self._total_time_taken_in_mins + + @total_time_taken_in_mins.setter + def total_time_taken_in_mins(self, total_time_taken_in_mins): + """ + Sets the total_time_taken_in_mins of this MaintenanceRunSummary. + The total time taken by corresponding resource activity in minutes. + + + :param total_time_taken_in_mins: The total_time_taken_in_mins of this MaintenanceRunSummary. + :type: int + """ + self._total_time_taken_in_mins = total_time_taken_in_mins + @property def database_software_image_id(self): """ diff --git a/src/oci/database/models/move_execution_action_member_details.py b/src/oci/database/models/move_execution_action_member_details.py new file mode 100644 index 0000000000..9ac8d02b89 --- /dev/null +++ b/src/oci/database/models/move_execution_action_member_details.py @@ -0,0 +1,220 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 MoveExecutionActionMemberDetails(object): + """ + Request to move an execution action member to an execution action resource from another. + """ + + def __init__(self, **kwargs): + """ + Initializes a new MoveExecutionActionMemberDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param source_execution_action_id: + The value to assign to the source_execution_action_id property of this MoveExecutionActionMemberDetails. + :type source_execution_action_id: str + + :param execution_action_member_id: + The value to assign to the execution_action_member_id property of this MoveExecutionActionMemberDetails. + :type execution_action_member_id: str + + :param execution_action_member_count: + The value to assign to the execution_action_member_count property of this MoveExecutionActionMemberDetails. + :type execution_action_member_count: int + + :param freeform_tags: + The value to assign to the freeform_tags property of this MoveExecutionActionMemberDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this MoveExecutionActionMemberDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'source_execution_action_id': 'str', + 'execution_action_member_id': 'str', + 'execution_action_member_count': 'int', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'source_execution_action_id': 'sourceExecutionActionId', + 'execution_action_member_id': 'executionActionMemberId', + 'execution_action_member_count': 'executionActionMemberCount', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._source_execution_action_id = None + self._execution_action_member_id = None + self._execution_action_member_count = None + self._freeform_tags = None + self._defined_tags = None + + @property + def source_execution_action_id(self): + """ + Gets the source_execution_action_id of this MoveExecutionActionMemberDetails. + The `OCID`__ of the source execution action resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The source_execution_action_id of this MoveExecutionActionMemberDetails. + :rtype: str + """ + return self._source_execution_action_id + + @source_execution_action_id.setter + def source_execution_action_id(self, source_execution_action_id): + """ + Sets the source_execution_action_id of this MoveExecutionActionMemberDetails. + The `OCID`__ of the source execution action resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param source_execution_action_id: The source_execution_action_id of this MoveExecutionActionMemberDetails. + :type: str + """ + self._source_execution_action_id = source_execution_action_id + + @property + def execution_action_member_id(self): + """ + Gets the execution_action_member_id of this MoveExecutionActionMemberDetails. + The `OCID`__ of the execution action member to be moved. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_action_member_id of this MoveExecutionActionMemberDetails. + :rtype: str + """ + return self._execution_action_member_id + + @execution_action_member_id.setter + def execution_action_member_id(self, execution_action_member_id): + """ + Sets the execution_action_member_id of this MoveExecutionActionMemberDetails. + The `OCID`__ of the execution action member to be moved. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_action_member_id: The execution_action_member_id of this MoveExecutionActionMemberDetails. + :type: str + """ + self._execution_action_member_id = execution_action_member_id + + @property + def execution_action_member_count(self): + """ + Gets the execution_action_member_count of this MoveExecutionActionMemberDetails. + The number of execution action member without ocids to be moved. + + + :return: The execution_action_member_count of this MoveExecutionActionMemberDetails. + :rtype: int + """ + return self._execution_action_member_count + + @execution_action_member_count.setter + def execution_action_member_count(self, execution_action_member_count): + """ + Sets the execution_action_member_count of this MoveExecutionActionMemberDetails. + The number of execution action member without ocids to be moved. + + + :param execution_action_member_count: The execution_action_member_count of this MoveExecutionActionMemberDetails. + :type: int + """ + self._execution_action_member_count = execution_action_member_count + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this MoveExecutionActionMemberDetails. + 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 MoveExecutionActionMemberDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this MoveExecutionActionMemberDetails. + 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 MoveExecutionActionMemberDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this MoveExecutionActionMemberDetails. + 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 MoveExecutionActionMemberDetails. + :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 MoveExecutionActionMemberDetails. + 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 MoveExecutionActionMemberDetails. + :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/recommended_scheduled_action_summary.py b/src/oci/database/models/recommended_scheduled_action_summary.py new file mode 100644 index 0000000000..2e54ed4873 --- /dev/null +++ b/src/oci/database/models/recommended_scheduled_action_summary.py @@ -0,0 +1,280 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 RecommendedScheduledActionSummary(object): + """ + Details of the scheduled action that is used in getRecommendedScheduledActions. + """ + + #: A constant which can be used with the action_type property of a RecommendedScheduledActionSummary. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a RecommendedScheduledActionSummary. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a RecommendedScheduledActionSummary. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + def __init__(self, **kwargs): + """ + Initializes a new RecommendedScheduledActionSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param action_order: + The value to assign to the action_order property of this RecommendedScheduledActionSummary. + :type action_order: int + + :param action_type: + The value to assign to the action_type property of this RecommendedScheduledActionSummary. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param display_name: + The value to assign to the display_name property of this RecommendedScheduledActionSummary. + :type display_name: str + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this RecommendedScheduledActionSummary. + :type scheduling_window_id: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this RecommendedScheduledActionSummary. + :type estimated_time_in_mins: int + + :param action_members: + The value to assign to the action_members property of this RecommendedScheduledActionSummary. + :type action_members: list[oci.database.models.ActionMember] + + :param action_params: + The value to assign to the action_params property of this RecommendedScheduledActionSummary. + :type action_params: dict(str, str) + + """ + self.swagger_types = { + 'action_order': 'int', + 'action_type': 'str', + 'display_name': 'str', + 'scheduling_window_id': 'str', + 'estimated_time_in_mins': 'int', + 'action_members': 'list[ActionMember]', + 'action_params': 'dict(str, str)' + } + + self.attribute_map = { + 'action_order': 'actionOrder', + 'action_type': 'actionType', + 'display_name': 'displayName', + 'scheduling_window_id': 'schedulingWindowId', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'action_members': 'actionMembers', + 'action_params': 'actionParams' + } + + self._action_order = None + self._action_type = None + self._display_name = None + self._scheduling_window_id = None + self._estimated_time_in_mins = None + self._action_members = None + self._action_params = None + + @property + def action_order(self): + """ + **[Required]** Gets the action_order of this RecommendedScheduledActionSummary. + The order of the scheduled action. + + + :return: The action_order of this RecommendedScheduledActionSummary. + :rtype: int + """ + return self._action_order + + @action_order.setter + def action_order(self, action_order): + """ + Sets the action_order of this RecommendedScheduledActionSummary. + The order of the scheduled action. + + + :param action_order: The action_order of this RecommendedScheduledActionSummary. + :type: int + """ + self._action_order = action_order + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this RecommendedScheduledActionSummary. + The type of the scheduled action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this RecommendedScheduledActionSummary. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this RecommendedScheduledActionSummary. + The type of the scheduled action being performed + + + :param action_type: The action_type of this RecommendedScheduledActionSummary. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def display_name(self): + """ + Gets the display_name of this RecommendedScheduledActionSummary. + Description of the scheduled action being performed, i.e. apply full update to DB Servers 1,2,3,4. + + + :return: The display_name of this RecommendedScheduledActionSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this RecommendedScheduledActionSummary. + Description of the scheduled action being performed, i.e. apply full update to DB Servers 1,2,3,4. + + + :param display_name: The display_name of this RecommendedScheduledActionSummary. + :type: str + """ + self._display_name = display_name + + @property + def scheduling_window_id(self): + """ + **[Required]** Gets the scheduling_window_id of this RecommendedScheduledActionSummary. + The id of the scheduling window this scheduled action belongs to. + + + :return: The scheduling_window_id of this RecommendedScheduledActionSummary. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this RecommendedScheduledActionSummary. + The id of the scheduling window this scheduled action belongs to. + + + :param scheduling_window_id: The scheduling_window_id of this RecommendedScheduledActionSummary. + :type: str + """ + self._scheduling_window_id = scheduling_window_id + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this RecommendedScheduledActionSummary. + The estimated patching time in minutes for the entire scheduled action. + + + :return: The estimated_time_in_mins of this RecommendedScheduledActionSummary. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this RecommendedScheduledActionSummary. + The estimated patching time in minutes for the entire scheduled action. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this RecommendedScheduledActionSummary. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def action_members(self): + """ + Gets the action_members of this RecommendedScheduledActionSummary. + The list of action members in a scheduled action. + + + :return: The action_members of this RecommendedScheduledActionSummary. + :rtype: list[oci.database.models.ActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this RecommendedScheduledActionSummary. + The list of action members in a scheduled action. + + + :param action_members: The action_members of this RecommendedScheduledActionSummary. + :type: list[oci.database.models.ActionMember] + """ + self._action_members = action_members + + @property + def action_params(self): + """ + Gets the action_params of this RecommendedScheduledActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this RecommendedScheduledActionSummary. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this RecommendedScheduledActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this RecommendedScheduledActionSummary. + :type: dict(str, str) + """ + self._action_params = action_params + + 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/recommended_scheduled_actions_collection.py b/src/oci/database/models/recommended_scheduled_actions_collection.py new file mode 100644 index 0000000000..5f91ec1f64 --- /dev/null +++ b/src/oci/database/models/recommended_scheduled_actions_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 RecommendedScheduledActionsCollection(object): + """ + A list of scheduled actions. Contains RecommendedScheduledAction items. + """ + + def __init__(self, **kwargs): + """ + Initializes a new RecommendedScheduledActionsCollection 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 RecommendedScheduledActionsCollection. + :type items: list[oci.database.models.RecommendedScheduledActionSummary] + + """ + self.swagger_types = { + 'items': 'list[RecommendedScheduledActionSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this RecommendedScheduledActionsCollection. + List of scheduled actions. + + + :return: The items of this RecommendedScheduledActionsCollection. + :rtype: list[oci.database.models.RecommendedScheduledActionSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this RecommendedScheduledActionsCollection. + List of scheduled actions. + + + :param items: The items of this RecommendedScheduledActionsCollection. + :type: list[oci.database.models.RecommendedScheduledActionSummary] + """ + 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/database/models/reorder_execution_action_details.py b/src/oci/database/models/reorder_execution_action_details.py new file mode 100644 index 0000000000..62c1f8dbd0 --- /dev/null +++ b/src/oci/database/models/reorder_execution_action_details.py @@ -0,0 +1,152 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ReorderExecutionActionDetails(object): + """ + Describes the ordering list of execution actions for the execution window. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ReorderExecutionActionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param execution_action_order_list: + The value to assign to the execution_action_order_list property of this ReorderExecutionActionDetails. + :type execution_action_order_list: list[oci.database.models.ActionOrderDetails] + + :param freeform_tags: + The value to assign to the freeform_tags property of this ReorderExecutionActionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ReorderExecutionActionDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'execution_action_order_list': 'list[ActionOrderDetails]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'execution_action_order_list': 'executionActionOrderList', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._execution_action_order_list = None + self._freeform_tags = None + self._defined_tags = None + + @property + def execution_action_order_list(self): + """ + Gets the execution_action_order_list of this ReorderExecutionActionDetails. + List of action resources in a specific order. + Example: [{actionOrder: 1, actionResourceId: \"resourceId1\"}, {actionOrder: 2, actionResourceId: \"resourceId2\"}] + + + :return: The execution_action_order_list of this ReorderExecutionActionDetails. + :rtype: list[oci.database.models.ActionOrderDetails] + """ + return self._execution_action_order_list + + @execution_action_order_list.setter + def execution_action_order_list(self, execution_action_order_list): + """ + Sets the execution_action_order_list of this ReorderExecutionActionDetails. + List of action resources in a specific order. + Example: [{actionOrder: 1, actionResourceId: \"resourceId1\"}, {actionOrder: 2, actionResourceId: \"resourceId2\"}] + + + :param execution_action_order_list: The execution_action_order_list of this ReorderExecutionActionDetails. + :type: list[oci.database.models.ActionOrderDetails] + """ + self._execution_action_order_list = execution_action_order_list + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ReorderExecutionActionDetails. + 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 ReorderExecutionActionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ReorderExecutionActionDetails. + 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 ReorderExecutionActionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ReorderExecutionActionDetails. + 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 ReorderExecutionActionDetails. + :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 ReorderExecutionActionDetails. + 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 ReorderExecutionActionDetails. + :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/reorder_scheduled_actions_details.py b/src/oci/database/models/reorder_scheduled_actions_details.py new file mode 100644 index 0000000000..888562edfb --- /dev/null +++ b/src/oci/database/models/reorder_scheduled_actions_details.py @@ -0,0 +1,109 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ReorderScheduledActionsDetails(object): + """ + Describes the re-order parameters for the Scheduled Action resources. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ReorderScheduledActionsDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this ReorderScheduledActionsDetails. + :type scheduling_window_id: str + + :param scheduled_action_id_orders: + The value to assign to the scheduled_action_id_orders property of this ReorderScheduledActionsDetails. + :type scheduled_action_id_orders: list[oci.database.models.ActionOrderDetails] + + """ + self.swagger_types = { + 'scheduling_window_id': 'str', + 'scheduled_action_id_orders': 'list[ActionOrderDetails]' + } + + self.attribute_map = { + 'scheduling_window_id': 'schedulingWindowId', + 'scheduled_action_id_orders': 'scheduledActionIdOrders' + } + + self._scheduling_window_id = None + self._scheduled_action_id_orders = None + + @property + def scheduling_window_id(self): + """ + **[Required]** Gets the scheduling_window_id of this ReorderScheduledActionsDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_window_id of this ReorderScheduledActionsDetails. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this ReorderScheduledActionsDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_window_id: The scheduling_window_id of this ReorderScheduledActionsDetails. + :type: str + """ + self._scheduling_window_id = scheduling_window_id + + @property + def scheduled_action_id_orders(self): + """ + **[Required]** Gets the scheduled_action_id_orders of this ReorderScheduledActionsDetails. + List of action resources in a specific order. + Example: [{actionOrder: 1, actionResourceId: \"resourceId1\"}, {actionOrder: 2, actionResourceId: \"resourceId2\"}] + + + :return: The scheduled_action_id_orders of this ReorderScheduledActionsDetails. + :rtype: list[oci.database.models.ActionOrderDetails] + """ + return self._scheduled_action_id_orders + + @scheduled_action_id_orders.setter + def scheduled_action_id_orders(self, scheduled_action_id_orders): + """ + Sets the scheduled_action_id_orders of this ReorderScheduledActionsDetails. + List of action resources in a specific order. + Example: [{actionOrder: 1, actionResourceId: \"resourceId1\"}, {actionOrder: 2, actionResourceId: \"resourceId2\"}] + + + :param scheduled_action_id_orders: The scheduled_action_id_orders of this ReorderScheduledActionsDetails. + :type: list[oci.database.models.ActionOrderDetails] + """ + self._scheduled_action_id_orders = scheduled_action_id_orders + + 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/scheduled_action.py b/src/oci/database/models/scheduled_action.py new file mode 100644 index 0000000000..f2944b9f6b --- /dev/null +++ b/src/oci/database/models/scheduled_action.py @@ -0,0 +1,633 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ScheduledAction(object): + """ + Details of a Scheduled Action. + """ + + #: A constant which can be used with the action_type property of a ScheduledAction. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ScheduledAction. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ScheduledAction. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledAction. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + def __init__(self, **kwargs): + """ + Initializes a new ScheduledAction 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 ScheduledAction. + :type id: str + + :param scheduling_plan_id: + The value to assign to the scheduling_plan_id property of this ScheduledAction. + :type scheduling_plan_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ScheduledAction. + :type compartment_id: str + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this ScheduledAction. + :type scheduling_window_id: str + + :param display_name: + The value to assign to the display_name property of this ScheduledAction. + :type display_name: str + + :param action_order: + The value to assign to the action_order property of this ScheduledAction. + :type action_order: int + + :param action_type: + The value to assign to the action_type property of this ScheduledAction. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ScheduledAction. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ScheduledAction. + :type estimated_time_in_mins: int + + :param action_params: + The value to assign to the action_params property of this ScheduledAction. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this ScheduledAction. + :type action_members: list[oci.database.models.ActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this ScheduledAction. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ScheduledAction. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this ScheduledAction. + :type system_tags: dict(str, dict(str, object)) + + :param time_created: + The value to assign to the time_created property of this ScheduledAction. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ScheduledAction. + :type time_updated: datetime + + """ + self.swagger_types = { + 'id': 'str', + 'scheduling_plan_id': 'str', + 'compartment_id': 'str', + 'scheduling_window_id': 'str', + 'display_name': 'str', + 'action_order': 'int', + 'action_type': 'str', + 'lifecycle_state': 'str', + 'estimated_time_in_mins': 'int', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))', + 'time_created': 'datetime', + 'time_updated': 'datetime' + } + + self.attribute_map = { + 'id': 'id', + 'scheduling_plan_id': 'schedulingPlanId', + 'compartment_id': 'compartmentId', + 'scheduling_window_id': 'schedulingWindowId', + 'display_name': 'displayName', + 'action_order': 'actionOrder', + 'action_type': 'actionType', + 'lifecycle_state': 'lifecycleState', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated' + } + + self._id = None + self._scheduling_plan_id = None + self._compartment_id = None + self._scheduling_window_id = None + self._display_name = None + self._action_order = None + self._action_type = None + self._lifecycle_state = None + self._estimated_time_in_mins = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + self._time_created = None + self._time_updated = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ScheduledAction. + The `OCID`__ of the Scheduled Action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ScheduledAction. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ScheduledAction. + The `OCID`__ of the Scheduled Action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ScheduledAction. + :type: str + """ + self._id = id + + @property + def scheduling_plan_id(self): + """ + **[Required]** Gets the scheduling_plan_id of this ScheduledAction. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_plan_id of this ScheduledAction. + :rtype: str + """ + return self._scheduling_plan_id + + @scheduling_plan_id.setter + def scheduling_plan_id(self, scheduling_plan_id): + """ + Sets the scheduling_plan_id of this ScheduledAction. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_plan_id: The scheduling_plan_id of this ScheduledAction. + :type: str + """ + self._scheduling_plan_id = scheduling_plan_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ScheduledAction. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ScheduledAction. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ScheduledAction. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ScheduledAction. + :type: str + """ + self._compartment_id = compartment_id + + @property + def scheduling_window_id(self): + """ + Gets the scheduling_window_id of this ScheduledAction. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_window_id of this ScheduledAction. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this ScheduledAction. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_window_id: The scheduling_window_id of this ScheduledAction. + :type: str + """ + self._scheduling_window_id = scheduling_window_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ScheduledAction. + The display name of the Scheduled Action. + + + :return: The display_name of this ScheduledAction. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ScheduledAction. + The display name of the Scheduled Action. + + + :param display_name: The display_name of this ScheduledAction. + :type: str + """ + self._display_name = display_name + + @property + def action_order(self): + """ + **[Required]** Gets the action_order of this ScheduledAction. + The order of the scheduled action. + + + :return: The action_order of this ScheduledAction. + :rtype: int + """ + return self._action_order + + @action_order.setter + def action_order(self, action_order): + """ + Sets the action_order of this ScheduledAction. + The order of the scheduled action. + + + :param action_order: The action_order of this ScheduledAction. + :type: int + """ + self._action_order = action_order + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this ScheduledAction. + The type of the scheduled action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this ScheduledAction. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this ScheduledAction. + The type of the scheduled action being performed + + + :param action_type: The action_type of this ScheduledAction. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ScheduledAction. + The current state of the Scheduled Action. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ScheduledAction. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ScheduledAction. + The current state of the Scheduled Action. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this ScheduledAction. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ScheduledAction. + The estimated patching time for the scheduled action. + + + :return: The estimated_time_in_mins of this ScheduledAction. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ScheduledAction. + The estimated patching time for the scheduled action. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ScheduledAction. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def action_params(self): + """ + Gets the action_params of this ScheduledAction. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this ScheduledAction. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this ScheduledAction. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this ScheduledAction. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this ScheduledAction. + The list of action members in a scheduled action. + + + :return: The action_members of this ScheduledAction. + :rtype: list[oci.database.models.ActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this ScheduledAction. + The list of action members in a scheduled action. + + + :param action_members: The action_members of this ScheduledAction. + :type: list[oci.database.models.ActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ScheduledAction. + 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 ScheduledAction. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ScheduledAction. + 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 ScheduledAction. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ScheduledAction. + 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 ScheduledAction. + :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 ScheduledAction. + 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 ScheduledAction. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this ScheduledAction. + System 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 system_tags of this ScheduledAction. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this ScheduledAction. + System 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 system_tags: The system_tags of this ScheduledAction. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ScheduledAction. + The date and time the Scheduled Action Resource was created. + + + :return: The time_created of this ScheduledAction. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ScheduledAction. + The date and time the Scheduled Action Resource was created. + + + :param time_created: The time_created of this ScheduledAction. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ScheduledAction. + The date and time the Scheduled Action Resource was updated. + + + :return: The time_updated of this ScheduledAction. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ScheduledAction. + The date and time the Scheduled Action Resource was updated. + + + :param time_updated: The time_updated of this ScheduledAction. + :type: datetime + """ + self._time_updated = time_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/scheduled_action_collection.py b/src/oci/database/models/scheduled_action_collection.py new file mode 100644 index 0000000000..e999f1134e --- /dev/null +++ b/src/oci/database/models/scheduled_action_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ScheduledActionCollection(object): + """ + Results of Scheduled Action resources lists. Contains ScheduledActionSummary items. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ScheduledActionCollection 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 ScheduledActionCollection. + :type items: list[oci.database.models.ScheduledActionSummary] + + """ + self.swagger_types = { + 'items': 'list[ScheduledActionSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ScheduledActionCollection. + List of Scheduled Action resources. + + + :return: The items of this ScheduledActionCollection. + :rtype: list[oci.database.models.ScheduledActionSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ScheduledActionCollection. + List of Scheduled Action resources. + + + :param items: The items of this ScheduledActionCollection. + :type: list[oci.database.models.ScheduledActionSummary] + """ + 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/database/models/scheduled_action_summary.py b/src/oci/database/models/scheduled_action_summary.py new file mode 100644 index 0000000000..cbc456eb91 --- /dev/null +++ b/src/oci/database/models/scheduled_action_summary.py @@ -0,0 +1,633 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 ScheduledActionSummary(object): + """ + Details of a scheduled action. + """ + + #: A constant which can be used with the action_type property of a ScheduledActionSummary. + #: This constant has a value of "DB_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_DB_SERVER_FULL_SOFTWARE_UPDATE = "DB_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ScheduledActionSummary. + #: This constant has a value of "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_STORAGE_SERVER_FULL_SOFTWARE_UPDATE = "STORAGE_SERVER_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the action_type property of a ScheduledActionSummary. + #: This constant has a value of "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + ACTION_TYPE_NETWORK_SWITCH_FULL_SOFTWARE_UPDATE = "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a ScheduledActionSummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + def __init__(self, **kwargs): + """ + Initializes a new ScheduledActionSummary 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 ScheduledActionSummary. + :type id: str + + :param scheduling_plan_id: + The value to assign to the scheduling_plan_id property of this ScheduledActionSummary. + :type scheduling_plan_id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ScheduledActionSummary. + :type compartment_id: str + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this ScheduledActionSummary. + :type scheduling_window_id: str + + :param display_name: + The value to assign to the display_name property of this ScheduledActionSummary. + :type display_name: str + + :param action_order: + The value to assign to the action_order property of this ScheduledActionSummary. + :type action_order: int + + :param action_type: + The value to assign to the action_type property of this ScheduledActionSummary. + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ScheduledActionSummary. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this ScheduledActionSummary. + :type estimated_time_in_mins: int + + :param action_params: + The value to assign to the action_params property of this ScheduledActionSummary. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this ScheduledActionSummary. + :type action_members: list[oci.database.models.ActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this ScheduledActionSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ScheduledActionSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this ScheduledActionSummary. + :type system_tags: dict(str, dict(str, object)) + + :param time_created: + The value to assign to the time_created property of this ScheduledActionSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ScheduledActionSummary. + :type time_updated: datetime + + """ + self.swagger_types = { + 'id': 'str', + 'scheduling_plan_id': 'str', + 'compartment_id': 'str', + 'scheduling_window_id': 'str', + 'display_name': 'str', + 'action_order': 'int', + 'action_type': 'str', + 'lifecycle_state': 'str', + 'estimated_time_in_mins': 'int', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))', + 'time_created': 'datetime', + 'time_updated': 'datetime' + } + + self.attribute_map = { + 'id': 'id', + 'scheduling_plan_id': 'schedulingPlanId', + 'compartment_id': 'compartmentId', + 'scheduling_window_id': 'schedulingWindowId', + 'display_name': 'displayName', + 'action_order': 'actionOrder', + 'action_type': 'actionType', + 'lifecycle_state': 'lifecycleState', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated' + } + + self._id = None + self._scheduling_plan_id = None + self._compartment_id = None + self._scheduling_window_id = None + self._display_name = None + self._action_order = None + self._action_type = None + self._lifecycle_state = None + self._estimated_time_in_mins = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + self._time_created = None + self._time_updated = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ScheduledActionSummary. + The `OCID`__ of the Scheduled Action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this ScheduledActionSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ScheduledActionSummary. + The `OCID`__ of the Scheduled Action. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this ScheduledActionSummary. + :type: str + """ + self._id = id + + @property + def scheduling_plan_id(self): + """ + **[Required]** Gets the scheduling_plan_id of this ScheduledActionSummary. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_plan_id of this ScheduledActionSummary. + :rtype: str + """ + return self._scheduling_plan_id + + @scheduling_plan_id.setter + def scheduling_plan_id(self, scheduling_plan_id): + """ + Sets the scheduling_plan_id of this ScheduledActionSummary. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_plan_id: The scheduling_plan_id of this ScheduledActionSummary. + :type: str + """ + self._scheduling_plan_id = scheduling_plan_id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this ScheduledActionSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this ScheduledActionSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ScheduledActionSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this ScheduledActionSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def scheduling_window_id(self): + """ + Gets the scheduling_window_id of this ScheduledActionSummary. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_window_id of this ScheduledActionSummary. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this ScheduledActionSummary. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_window_id: The scheduling_window_id of this ScheduledActionSummary. + :type: str + """ + self._scheduling_window_id = scheduling_window_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this ScheduledActionSummary. + The display name of the Scheduled Action. + + + :return: The display_name of this ScheduledActionSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this ScheduledActionSummary. + The display name of the Scheduled Action. + + + :param display_name: The display_name of this ScheduledActionSummary. + :type: str + """ + self._display_name = display_name + + @property + def action_order(self): + """ + **[Required]** Gets the action_order of this ScheduledActionSummary. + The order of the scheduled action. + + + :return: The action_order of this ScheduledActionSummary. + :rtype: int + """ + return self._action_order + + @action_order.setter + def action_order(self, action_order): + """ + Sets the action_order of this ScheduledActionSummary. + The order of the scheduled action. + + + :param action_order: The action_order of this ScheduledActionSummary. + :type: int + """ + self._action_order = action_order + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this ScheduledActionSummary. + The type of the scheduled action being performed + + Allowed values for this property are: "DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this ScheduledActionSummary. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this ScheduledActionSummary. + The type of the scheduled action being performed + + + :param action_type: The action_type of this ScheduledActionSummary. + :type: str + """ + allowed_values = ["DB_SERVER_FULL_SOFTWARE_UPDATE", "STORAGE_SERVER_FULL_SOFTWARE_UPDATE", "NETWORK_SWITCH_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this ScheduledActionSummary. + The current state of the Scheduled Action. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ScheduledActionSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ScheduledActionSummary. + The current state of the Scheduled Action. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this ScheduledActionSummary. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this ScheduledActionSummary. + The estimated patching time for the scheduled action. + + + :return: The estimated_time_in_mins of this ScheduledActionSummary. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this ScheduledActionSummary. + The estimated patching time for the scheduled action. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this ScheduledActionSummary. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def action_params(self): + """ + Gets the action_params of this ScheduledActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this ScheduledActionSummary. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this ScheduledActionSummary. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this ScheduledActionSummary. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this ScheduledActionSummary. + The list of action members in a scheduled action. + + + :return: The action_members of this ScheduledActionSummary. + :rtype: list[oci.database.models.ActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this ScheduledActionSummary. + The list of action members in a scheduled action. + + + :param action_members: The action_members of this ScheduledActionSummary. + :type: list[oci.database.models.ActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ScheduledActionSummary. + 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 ScheduledActionSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ScheduledActionSummary. + 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 ScheduledActionSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ScheduledActionSummary. + 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 ScheduledActionSummary. + :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 ScheduledActionSummary. + 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 ScheduledActionSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this ScheduledActionSummary. + System 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 system_tags of this ScheduledActionSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this ScheduledActionSummary. + System 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 system_tags: The system_tags of this ScheduledActionSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this ScheduledActionSummary. + The date and time the Scheduled Action Resource was created. + + + :return: The time_created of this ScheduledActionSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ScheduledActionSummary. + The date and time the Scheduled Action Resource was created. + + + :param time_created: The time_created of this ScheduledActionSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ScheduledActionSummary. + The date and time the Scheduled Action Resource was updated. + + + :return: The time_updated of this ScheduledActionSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ScheduledActionSummary. + The date and time the Scheduled Action Resource was updated. + + + :param time_updated: The time_updated of this ScheduledActionSummary. + :type: datetime + """ + self._time_updated = time_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/scheduling_plan.py b/src/oci/database/models/scheduling_plan.py new file mode 100644 index 0000000000..69c539a0c1 --- /dev/null +++ b/src/oci/database/models/scheduling_plan.py @@ -0,0 +1,643 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingPlan(object): + """ + Details of a Scheduling Plan. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlan. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the plan_intent property of a SchedulingPlan. + #: This constant has a value of "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE" + PLAN_INTENT_EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE = "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the service_type property of a SchedulingPlan. + #: This constant has a value of "EXACC" + SERVICE_TYPE_EXACC = "EXACC" + + #: A constant which can be used with the service_type property of a SchedulingPlan. + #: This constant has a value of "EXACS" + SERVICE_TYPE_EXACS = "EXACS" + + #: A constant which can be used with the service_type property of a SchedulingPlan. + #: This constant has a value of "FPPPCS" + SERVICE_TYPE_FPPPCS = "FPPPCS" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingPlan 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 SchedulingPlan. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingPlan. + :type compartment_id: str + + :param scheduling_policy_id: + The value to assign to the scheduling_policy_id property of this SchedulingPlan. + :type scheduling_policy_id: str + + :param resource_id: + The value to assign to the resource_id property of this SchedulingPlan. + :type resource_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingPlan. + :type display_name: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingPlan. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingPlan. + :type lifecycle_details: str + + :param is_using_recommended_scheduled_actions: + The value to assign to the is_using_recommended_scheduled_actions property of this SchedulingPlan. + :type is_using_recommended_scheduled_actions: bool + + :param plan_intent: + The value to assign to the plan_intent property of this SchedulingPlan. + Allowed values for this property are: "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type plan_intent: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this SchedulingPlan. + :type estimated_time_in_mins: int + + :param service_type: + The value to assign to the service_type property of this SchedulingPlan. + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_type: str + + :param time_created: + The value to assign to the time_created property of this SchedulingPlan. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingPlan. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingPlan. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingPlan. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this SchedulingPlan. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'scheduling_policy_id': 'str', + 'resource_id': 'str', + 'display_name': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'is_using_recommended_scheduled_actions': 'bool', + 'plan_intent': 'str', + 'estimated_time_in_mins': 'int', + 'service_type': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'scheduling_policy_id': 'schedulingPolicyId', + 'resource_id': 'resourceId', + 'display_name': 'displayName', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'is_using_recommended_scheduled_actions': 'isUsingRecommendedScheduledActions', + 'plan_intent': 'planIntent', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'service_type': 'serviceType', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._scheduling_policy_id = None + self._resource_id = None + self._display_name = None + self._lifecycle_state = None + self._lifecycle_details = None + self._is_using_recommended_scheduled_actions = None + self._plan_intent = None + self._estimated_time_in_mins = None + self._service_type = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingPlan. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingPlan. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingPlan. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingPlan. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this SchedulingPlan. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingPlan. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingPlan. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingPlan. + :type: str + """ + self._compartment_id = compartment_id + + @property + def scheduling_policy_id(self): + """ + **[Required]** Gets the scheduling_policy_id of this SchedulingPlan. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_policy_id of this SchedulingPlan. + :rtype: str + """ + return self._scheduling_policy_id + + @scheduling_policy_id.setter + def scheduling_policy_id(self, scheduling_policy_id): + """ + Sets the scheduling_policy_id of this SchedulingPlan. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_policy_id: The scheduling_policy_id of this SchedulingPlan. + :type: str + """ + self._scheduling_policy_id = scheduling_policy_id + + @property + def resource_id(self): + """ + **[Required]** Gets the resource_id of this SchedulingPlan. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The resource_id of this SchedulingPlan. + :rtype: str + """ + return self._resource_id + + @resource_id.setter + def resource_id(self, resource_id): + """ + Sets the resource_id of this SchedulingPlan. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param resource_id: The resource_id of this SchedulingPlan. + :type: str + """ + self._resource_id = resource_id + + @property + def display_name(self): + """ + Gets the display_name of this SchedulingPlan. + The display name of the Scheduling Plan. + + + :return: The display_name of this SchedulingPlan. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingPlan. + The display name of the Scheduling Plan. + + + :param display_name: The display_name of this SchedulingPlan. + :type: str + """ + self._display_name = display_name + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingPlan. + The current state of the Scheduling Plan. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingPlan. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingPlan. + The current state of the Scheduling Plan. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingPlan. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingPlan. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingPlan. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingPlan. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingPlan. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def is_using_recommended_scheduled_actions(self): + """ + Gets the is_using_recommended_scheduled_actions of this SchedulingPlan. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :return: The is_using_recommended_scheduled_actions of this SchedulingPlan. + :rtype: bool + """ + return self._is_using_recommended_scheduled_actions + + @is_using_recommended_scheduled_actions.setter + def is_using_recommended_scheduled_actions(self, is_using_recommended_scheduled_actions): + """ + Sets the is_using_recommended_scheduled_actions of this SchedulingPlan. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :param is_using_recommended_scheduled_actions: The is_using_recommended_scheduled_actions of this SchedulingPlan. + :type: bool + """ + self._is_using_recommended_scheduled_actions = is_using_recommended_scheduled_actions + + @property + def plan_intent(self): + """ + Gets the plan_intent of this SchedulingPlan. + The current intent the Scheduling Plan. Valid states is EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE. + + Allowed values for this property are: "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The plan_intent of this SchedulingPlan. + :rtype: str + """ + return self._plan_intent + + @plan_intent.setter + def plan_intent(self, plan_intent): + """ + Sets the plan_intent of this SchedulingPlan. + The current intent the Scheduling Plan. Valid states is EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE. + + + :param plan_intent: The plan_intent of this SchedulingPlan. + :type: str + """ + allowed_values = ["EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(plan_intent, allowed_values): + plan_intent = 'UNKNOWN_ENUM_VALUE' + self._plan_intent = plan_intent + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this SchedulingPlan. + The estimated time for the Scheduling Plan. + + + :return: The estimated_time_in_mins of this SchedulingPlan. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this SchedulingPlan. + The estimated time for the Scheduling Plan. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this SchedulingPlan. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def service_type(self): + """ + **[Required]** Gets the service_type of this SchedulingPlan. + The service type of the Scheduling Plan. + + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_type of this SchedulingPlan. + :rtype: str + """ + return self._service_type + + @service_type.setter + def service_type(self, service_type): + """ + Sets the service_type of this SchedulingPlan. + The service type of the Scheduling Plan. + + + :param service_type: The service_type of this SchedulingPlan. + :type: str + """ + allowed_values = ["EXACC", "EXACS", "FPPPCS"] + if not value_allowed_none_or_none_sentinel(service_type, allowed_values): + service_type = 'UNKNOWN_ENUM_VALUE' + self._service_type = service_type + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this SchedulingPlan. + The date and time the Scheduling Plan Resource was created. + + + :return: The time_created of this SchedulingPlan. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingPlan. + The date and time the Scheduling Plan Resource was created. + + + :param time_created: The time_created of this SchedulingPlan. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingPlan. + The date and time the Scheduling Plan Resource was updated. + + + :return: The time_updated of this SchedulingPlan. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingPlan. + The date and time the Scheduling Plan Resource was updated. + + + :param time_updated: The time_updated of this SchedulingPlan. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingPlan. + 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 SchedulingPlan. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingPlan. + 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 SchedulingPlan. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingPlan. + 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 SchedulingPlan. + :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 SchedulingPlan. + 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 SchedulingPlan. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this SchedulingPlan. + System 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 system_tags of this SchedulingPlan. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this SchedulingPlan. + System 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 system_tags: The system_tags of this SchedulingPlan. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/scheduling_plan_collection.py b/src/oci/database/models/scheduling_plan_collection.py new file mode 100644 index 0000000000..8a2464d241 --- /dev/null +++ b/src/oci/database/models/scheduling_plan_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingPlanCollection(object): + """ + Results of Scheduling Plan resources lists. Contains ScheduledActionSummary items. + """ + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingPlanCollection 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 SchedulingPlanCollection. + :type items: list[oci.database.models.SchedulingPlanSummary] + + """ + self.swagger_types = { + 'items': 'list[SchedulingPlanSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this SchedulingPlanCollection. + List of Scheduling Plan resources. + + + :return: The items of this SchedulingPlanCollection. + :rtype: list[oci.database.models.SchedulingPlanSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this SchedulingPlanCollection. + List of Scheduling Plan resources. + + + :param items: The items of this SchedulingPlanCollection. + :type: list[oci.database.models.SchedulingPlanSummary] + """ + 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/database/models/scheduling_plan_summary.py b/src/oci/database/models/scheduling_plan_summary.py new file mode 100644 index 0000000000..b05a1d9b21 --- /dev/null +++ b/src/oci/database/models/scheduling_plan_summary.py @@ -0,0 +1,643 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingPlanSummary(object): + """ + Details of a Scheduling Plan. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPlanSummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the plan_intent property of a SchedulingPlanSummary. + #: This constant has a value of "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE" + PLAN_INTENT_EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE = "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE" + + #: A constant which can be used with the service_type property of a SchedulingPlanSummary. + #: This constant has a value of "EXACC" + SERVICE_TYPE_EXACC = "EXACC" + + #: A constant which can be used with the service_type property of a SchedulingPlanSummary. + #: This constant has a value of "EXACS" + SERVICE_TYPE_EXACS = "EXACS" + + #: A constant which can be used with the service_type property of a SchedulingPlanSummary. + #: This constant has a value of "FPPPCS" + SERVICE_TYPE_FPPPCS = "FPPPCS" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingPlanSummary 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 SchedulingPlanSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingPlanSummary. + :type compartment_id: str + + :param scheduling_policy_id: + The value to assign to the scheduling_policy_id property of this SchedulingPlanSummary. + :type scheduling_policy_id: str + + :param resource_id: + The value to assign to the resource_id property of this SchedulingPlanSummary. + :type resource_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingPlanSummary. + :type display_name: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingPlanSummary. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingPlanSummary. + :type lifecycle_details: str + + :param is_using_recommended_scheduled_actions: + The value to assign to the is_using_recommended_scheduled_actions property of this SchedulingPlanSummary. + :type is_using_recommended_scheduled_actions: bool + + :param plan_intent: + The value to assign to the plan_intent property of this SchedulingPlanSummary. + Allowed values for this property are: "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type plan_intent: str + + :param estimated_time_in_mins: + The value to assign to the estimated_time_in_mins property of this SchedulingPlanSummary. + :type estimated_time_in_mins: int + + :param service_type: + The value to assign to the service_type property of this SchedulingPlanSummary. + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_type: str + + :param time_created: + The value to assign to the time_created property of this SchedulingPlanSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingPlanSummary. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingPlanSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingPlanSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this SchedulingPlanSummary. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'scheduling_policy_id': 'str', + 'resource_id': 'str', + 'display_name': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'is_using_recommended_scheduled_actions': 'bool', + 'plan_intent': 'str', + 'estimated_time_in_mins': 'int', + 'service_type': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'scheduling_policy_id': 'schedulingPolicyId', + 'resource_id': 'resourceId', + 'display_name': 'displayName', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'is_using_recommended_scheduled_actions': 'isUsingRecommendedScheduledActions', + 'plan_intent': 'planIntent', + 'estimated_time_in_mins': 'estimatedTimeInMins', + 'service_type': 'serviceType', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._scheduling_policy_id = None + self._resource_id = None + self._display_name = None + self._lifecycle_state = None + self._lifecycle_details = None + self._is_using_recommended_scheduled_actions = None + self._plan_intent = None + self._estimated_time_in_mins = None + self._service_type = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingPlanSummary. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingPlanSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingPlanSummary. + The `OCID`__ of the Scheduling Plan. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingPlanSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this SchedulingPlanSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingPlanSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingPlanSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingPlanSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def scheduling_policy_id(self): + """ + **[Required]** Gets the scheduling_policy_id of this SchedulingPlanSummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_policy_id of this SchedulingPlanSummary. + :rtype: str + """ + return self._scheduling_policy_id + + @scheduling_policy_id.setter + def scheduling_policy_id(self, scheduling_policy_id): + """ + Sets the scheduling_policy_id of this SchedulingPlanSummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_policy_id: The scheduling_policy_id of this SchedulingPlanSummary. + :type: str + """ + self._scheduling_policy_id = scheduling_policy_id + + @property + def resource_id(self): + """ + **[Required]** Gets the resource_id of this SchedulingPlanSummary. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The resource_id of this SchedulingPlanSummary. + :rtype: str + """ + return self._resource_id + + @resource_id.setter + def resource_id(self, resource_id): + """ + Sets the resource_id of this SchedulingPlanSummary. + The `OCID`__ of the resource. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param resource_id: The resource_id of this SchedulingPlanSummary. + :type: str + """ + self._resource_id = resource_id + + @property + def display_name(self): + """ + Gets the display_name of this SchedulingPlanSummary. + The display name of the Scheduling Plan. + + + :return: The display_name of this SchedulingPlanSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingPlanSummary. + The display name of the Scheduling Plan. + + + :param display_name: The display_name of this SchedulingPlanSummary. + :type: str + """ + self._display_name = display_name + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingPlanSummary. + The current state of the Scheduling Plan. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingPlanSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingPlanSummary. + The current state of the Scheduling Plan. Valid states are CREATING, NEEDS_ATTENTION, AVAILABLE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingPlanSummary. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingPlanSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingPlanSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingPlanSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingPlanSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def is_using_recommended_scheduled_actions(self): + """ + Gets the is_using_recommended_scheduled_actions of this SchedulingPlanSummary. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :return: The is_using_recommended_scheduled_actions of this SchedulingPlanSummary. + :rtype: bool + """ + return self._is_using_recommended_scheduled_actions + + @is_using_recommended_scheduled_actions.setter + def is_using_recommended_scheduled_actions(self, is_using_recommended_scheduled_actions): + """ + Sets the is_using_recommended_scheduled_actions of this SchedulingPlanSummary. + If true, recommended scheduled actions will be generated for the scheduling plan. + + + :param is_using_recommended_scheduled_actions: The is_using_recommended_scheduled_actions of this SchedulingPlanSummary. + :type: bool + """ + self._is_using_recommended_scheduled_actions = is_using_recommended_scheduled_actions + + @property + def plan_intent(self): + """ + Gets the plan_intent of this SchedulingPlanSummary. + The current intent the Scheduling Plan. Valid states is EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE. + + Allowed values for this property are: "EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The plan_intent of this SchedulingPlanSummary. + :rtype: str + """ + return self._plan_intent + + @plan_intent.setter + def plan_intent(self, plan_intent): + """ + Sets the plan_intent of this SchedulingPlanSummary. + The current intent the Scheduling Plan. Valid states is EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE. + + + :param plan_intent: The plan_intent of this SchedulingPlanSummary. + :type: str + """ + allowed_values = ["EXADATA_INFRASTRUCTURE_FULL_SOFTWARE_UPDATE"] + if not value_allowed_none_or_none_sentinel(plan_intent, allowed_values): + plan_intent = 'UNKNOWN_ENUM_VALUE' + self._plan_intent = plan_intent + + @property + def estimated_time_in_mins(self): + """ + Gets the estimated_time_in_mins of this SchedulingPlanSummary. + The estimated time for the Scheduling Plan. + + + :return: The estimated_time_in_mins of this SchedulingPlanSummary. + :rtype: int + """ + return self._estimated_time_in_mins + + @estimated_time_in_mins.setter + def estimated_time_in_mins(self, estimated_time_in_mins): + """ + Sets the estimated_time_in_mins of this SchedulingPlanSummary. + The estimated time for the Scheduling Plan. + + + :param estimated_time_in_mins: The estimated_time_in_mins of this SchedulingPlanSummary. + :type: int + """ + self._estimated_time_in_mins = estimated_time_in_mins + + @property + def service_type(self): + """ + **[Required]** Gets the service_type of this SchedulingPlanSummary. + The service type of the Scheduling Plan. + + Allowed values for this property are: "EXACC", "EXACS", "FPPPCS", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_type of this SchedulingPlanSummary. + :rtype: str + """ + return self._service_type + + @service_type.setter + def service_type(self, service_type): + """ + Sets the service_type of this SchedulingPlanSummary. + The service type of the Scheduling Plan. + + + :param service_type: The service_type of this SchedulingPlanSummary. + :type: str + """ + allowed_values = ["EXACC", "EXACS", "FPPPCS"] + if not value_allowed_none_or_none_sentinel(service_type, allowed_values): + service_type = 'UNKNOWN_ENUM_VALUE' + self._service_type = service_type + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this SchedulingPlanSummary. + The date and time the Scheduling Plan Resource was created. + + + :return: The time_created of this SchedulingPlanSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingPlanSummary. + The date and time the Scheduling Plan Resource was created. + + + :param time_created: The time_created of this SchedulingPlanSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingPlanSummary. + The date and time the Scheduling Plan Resource was updated. + + + :return: The time_updated of this SchedulingPlanSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingPlanSummary. + The date and time the Scheduling Plan Resource was updated. + + + :param time_updated: The time_updated of this SchedulingPlanSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingPlanSummary. + 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 SchedulingPlanSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingPlanSummary. + 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 SchedulingPlanSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingPlanSummary. + 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 SchedulingPlanSummary. + :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 SchedulingPlanSummary. + 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 SchedulingPlanSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this SchedulingPlanSummary. + System 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 system_tags of this SchedulingPlanSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this SchedulingPlanSummary. + System 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 system_tags: The system_tags of this SchedulingPlanSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/scheduling_policy.py b/src/oci/database/models/scheduling_policy.py new file mode 100644 index 0000000000..a0d252ce9f --- /dev/null +++ b/src/oci/database/models/scheduling_policy.py @@ -0,0 +1,493 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingPolicy(object): + """ + Details of a Scheduling Policy. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicy. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the cadence property of a SchedulingPolicy. + #: This constant has a value of "HALFYEARLY" + CADENCE_HALFYEARLY = "HALFYEARLY" + + #: A constant which can be used with the cadence property of a SchedulingPolicy. + #: This constant has a value of "QUARTERLY" + CADENCE_QUARTERLY = "QUARTERLY" + + #: A constant which can be used with the cadence property of a SchedulingPolicy. + #: This constant has a value of "MONTHLY" + CADENCE_MONTHLY = "MONTHLY" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingPolicy 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 SchedulingPolicy. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingPolicy. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingPolicy. + :type display_name: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingPolicy. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingPolicy. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this SchedulingPolicy. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingPolicy. + :type time_updated: datetime + + :param cadence: + The value to assign to the cadence property of this SchedulingPolicy. + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type cadence: str + + :param cadence_start_month: + The value to assign to the cadence_start_month property of this SchedulingPolicy. + :type cadence_start_month: oci.database.models.Month + + :param time_next_window_starts: + The value to assign to the time_next_window_starts property of this SchedulingPolicy. + :type time_next_window_starts: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingPolicy. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingPolicy. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'cadence': 'str', + 'cadence_start_month': 'Month', + 'time_next_window_starts': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'cadence': 'cadence', + 'cadence_start_month': 'cadenceStartMonth', + 'time_next_window_starts': 'timeNextWindowStarts', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._cadence = None + self._cadence_start_month = None + self._time_next_window_starts = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingPolicy. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingPolicy. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingPolicy. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingPolicy. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this SchedulingPolicy. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingPolicy. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingPolicy. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingPolicy. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this SchedulingPolicy. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :return: The display_name of this SchedulingPolicy. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingPolicy. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :param display_name: The display_name of this SchedulingPolicy. + :type: str + """ + self._display_name = display_name + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingPolicy. + The current state of the Scheduling Policy. Valid states are CREATING, NEEDS_ATTENTION, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingPolicy. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingPolicy. + The current state of the Scheduling Policy. Valid states are CREATING, NEEDS_ATTENTION, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingPolicy. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingPolicy. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingPolicy. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingPolicy. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingPolicy. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this SchedulingPolicy. + The date and time the Scheduling Policy was created. + + + :return: The time_created of this SchedulingPolicy. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingPolicy. + The date and time the Scheduling Policy was created. + + + :param time_created: The time_created of this SchedulingPolicy. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingPolicy. + The last date and time that the Scheduling Policy was updated. + + + :return: The time_updated of this SchedulingPolicy. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingPolicy. + The last date and time that the Scheduling Policy was updated. + + + :param time_updated: The time_updated of this SchedulingPolicy. + :type: datetime + """ + self._time_updated = time_updated + + @property + def cadence(self): + """ + **[Required]** Gets the cadence of this SchedulingPolicy. + The cadence period. + + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The cadence of this SchedulingPolicy. + :rtype: str + """ + return self._cadence + + @cadence.setter + def cadence(self, cadence): + """ + Sets the cadence of this SchedulingPolicy. + The cadence period. + + + :param cadence: The cadence of this SchedulingPolicy. + :type: str + """ + allowed_values = ["HALFYEARLY", "QUARTERLY", "MONTHLY"] + if not value_allowed_none_or_none_sentinel(cadence, allowed_values): + cadence = 'UNKNOWN_ENUM_VALUE' + self._cadence = cadence + + @property + def cadence_start_month(self): + """ + Gets the cadence_start_month of this SchedulingPolicy. + Start of the month to be followed during the cadence period. + + + :return: The cadence_start_month of this SchedulingPolicy. + :rtype: oci.database.models.Month + """ + return self._cadence_start_month + + @cadence_start_month.setter + def cadence_start_month(self, cadence_start_month): + """ + Sets the cadence_start_month of this SchedulingPolicy. + Start of the month to be followed during the cadence period. + + + :param cadence_start_month: The cadence_start_month of this SchedulingPolicy. + :type: oci.database.models.Month + """ + self._cadence_start_month = cadence_start_month + + @property + def time_next_window_starts(self): + """ + Gets the time_next_window_starts of this SchedulingPolicy. + The date and time of the next scheduling window associated with the schedulingPolicy is planned to start. + + + :return: The time_next_window_starts of this SchedulingPolicy. + :rtype: datetime + """ + return self._time_next_window_starts + + @time_next_window_starts.setter + def time_next_window_starts(self, time_next_window_starts): + """ + Sets the time_next_window_starts of this SchedulingPolicy. + The date and time of the next scheduling window associated with the schedulingPolicy is planned to start. + + + :param time_next_window_starts: The time_next_window_starts of this SchedulingPolicy. + :type: datetime + """ + self._time_next_window_starts = time_next_window_starts + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingPolicy. + 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 SchedulingPolicy. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingPolicy. + 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 SchedulingPolicy. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingPolicy. + 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 SchedulingPolicy. + :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 SchedulingPolicy. + 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 SchedulingPolicy. + :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/scheduling_policy_summary.py b/src/oci/database/models/scheduling_policy_summary.py new file mode 100644 index 0000000000..ad02729b5e --- /dev/null +++ b/src/oci/database/models/scheduling_policy_summary.py @@ -0,0 +1,493 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingPolicySummary(object): + """ + Details of a Scheduling Policy. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingPolicySummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the cadence property of a SchedulingPolicySummary. + #: This constant has a value of "HALFYEARLY" + CADENCE_HALFYEARLY = "HALFYEARLY" + + #: A constant which can be used with the cadence property of a SchedulingPolicySummary. + #: This constant has a value of "QUARTERLY" + CADENCE_QUARTERLY = "QUARTERLY" + + #: A constant which can be used with the cadence property of a SchedulingPolicySummary. + #: This constant has a value of "MONTHLY" + CADENCE_MONTHLY = "MONTHLY" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingPolicySummary 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 SchedulingPolicySummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingPolicySummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingPolicySummary. + :type display_name: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingPolicySummary. + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingPolicySummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this SchedulingPolicySummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingPolicySummary. + :type time_updated: datetime + + :param cadence: + The value to assign to the cadence property of this SchedulingPolicySummary. + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type cadence: str + + :param cadence_start_month: + The value to assign to the cadence_start_month property of this SchedulingPolicySummary. + :type cadence_start_month: oci.database.models.Month + + :param time_next_window_starts: + The value to assign to the time_next_window_starts property of this SchedulingPolicySummary. + :type time_next_window_starts: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingPolicySummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingPolicySummary. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'cadence': 'str', + 'cadence_start_month': 'Month', + 'time_next_window_starts': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'cadence': 'cadence', + 'cadence_start_month': 'cadenceStartMonth', + 'time_next_window_starts': 'timeNextWindowStarts', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._cadence = None + self._cadence_start_month = None + self._time_next_window_starts = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingPolicySummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingPolicySummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingPolicySummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingPolicySummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this SchedulingPolicySummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingPolicySummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingPolicySummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingPolicySummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this SchedulingPolicySummary. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :return: The display_name of this SchedulingPolicySummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingPolicySummary. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :param display_name: The display_name of this SchedulingPolicySummary. + :type: str + """ + self._display_name = display_name + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingPolicySummary. + The current state of the Scheduling Policy. Valid states are CREATING, NEEDS_ATTENTION, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingPolicySummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingPolicySummary. + The current state of the Scheduling Policy. Valid states are CREATING, NEEDS_ATTENTION, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingPolicySummary. + :type: str + """ + allowed_values = ["CREATING", "NEEDS_ATTENTION", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingPolicySummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingPolicySummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingPolicySummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingPolicySummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this SchedulingPolicySummary. + The date and time the Scheduling Policy was created. + + + :return: The time_created of this SchedulingPolicySummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingPolicySummary. + The date and time the Scheduling Policy was created. + + + :param time_created: The time_created of this SchedulingPolicySummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingPolicySummary. + The last date and time that the Scheduling Policy was updated. + + + :return: The time_updated of this SchedulingPolicySummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingPolicySummary. + The last date and time that the Scheduling Policy was updated. + + + :param time_updated: The time_updated of this SchedulingPolicySummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def cadence(self): + """ + **[Required]** Gets the cadence of this SchedulingPolicySummary. + The cadence period. + + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The cadence of this SchedulingPolicySummary. + :rtype: str + """ + return self._cadence + + @cadence.setter + def cadence(self, cadence): + """ + Sets the cadence of this SchedulingPolicySummary. + The cadence period. + + + :param cadence: The cadence of this SchedulingPolicySummary. + :type: str + """ + allowed_values = ["HALFYEARLY", "QUARTERLY", "MONTHLY"] + if not value_allowed_none_or_none_sentinel(cadence, allowed_values): + cadence = 'UNKNOWN_ENUM_VALUE' + self._cadence = cadence + + @property + def cadence_start_month(self): + """ + Gets the cadence_start_month of this SchedulingPolicySummary. + Start of the month to be followed during the cadence period. + + + :return: The cadence_start_month of this SchedulingPolicySummary. + :rtype: oci.database.models.Month + """ + return self._cadence_start_month + + @cadence_start_month.setter + def cadence_start_month(self, cadence_start_month): + """ + Sets the cadence_start_month of this SchedulingPolicySummary. + Start of the month to be followed during the cadence period. + + + :param cadence_start_month: The cadence_start_month of this SchedulingPolicySummary. + :type: oci.database.models.Month + """ + self._cadence_start_month = cadence_start_month + + @property + def time_next_window_starts(self): + """ + Gets the time_next_window_starts of this SchedulingPolicySummary. + The date and time of the next scheduling window associated with the schedulingPolicy is planned to start. + + + :return: The time_next_window_starts of this SchedulingPolicySummary. + :rtype: datetime + """ + return self._time_next_window_starts + + @time_next_window_starts.setter + def time_next_window_starts(self, time_next_window_starts): + """ + Sets the time_next_window_starts of this SchedulingPolicySummary. + The date and time of the next scheduling window associated with the schedulingPolicy is planned to start. + + + :param time_next_window_starts: The time_next_window_starts of this SchedulingPolicySummary. + :type: datetime + """ + self._time_next_window_starts = time_next_window_starts + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingPolicySummary. + 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 SchedulingPolicySummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingPolicySummary. + 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 SchedulingPolicySummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingPolicySummary. + 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 SchedulingPolicySummary. + :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 SchedulingPolicySummary. + 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 SchedulingPolicySummary. + :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/scheduling_window.py b/src/oci/database/models/scheduling_window.py new file mode 100644 index 0000000000..d9d2036d4c --- /dev/null +++ b/src/oci/database/models/scheduling_window.py @@ -0,0 +1,469 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingWindow(object): + """ + Details of a Scheduling Window. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindow. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingWindow 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 SchedulingWindow. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingWindow. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingWindow. + :type display_name: str + + :param time_next_scheduling_window_starts: + The value to assign to the time_next_scheduling_window_starts property of this SchedulingWindow. + :type time_next_scheduling_window_starts: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingWindow. + Allowed values for this property are: "CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingWindow. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this SchedulingWindow. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingWindow. + :type time_updated: datetime + + :param window_preference: + The value to assign to the window_preference property of this SchedulingWindow. + :type window_preference: oci.database.models.WindowPreferenceDetail + + :param scheduling_policy_id: + The value to assign to the scheduling_policy_id property of this SchedulingWindow. + :type scheduling_policy_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingWindow. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingWindow. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'time_next_scheduling_window_starts': 'datetime', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'window_preference': 'WindowPreferenceDetail', + 'scheduling_policy_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'time_next_scheduling_window_starts': 'timeNextSchedulingWindowStarts', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'window_preference': 'windowPreference', + 'scheduling_policy_id': 'schedulingPolicyId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._time_next_scheduling_window_starts = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._window_preference = None + self._scheduling_policy_id = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingWindow. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingWindow. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingWindow. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingWindow. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this SchedulingWindow. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingWindow. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingWindow. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingWindow. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this SchedulingWindow. + The user-friendly name for the Scheduling Window. The name does not need to be unique. + + + :return: The display_name of this SchedulingWindow. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingWindow. + The user-friendly name for the Scheduling Window. The name does not need to be unique. + + + :param display_name: The display_name of this SchedulingWindow. + :type: str + """ + self._display_name = display_name + + @property + def time_next_scheduling_window_starts(self): + """ + Gets the time_next_scheduling_window_starts of this SchedulingWindow. + The date and time of the next upcoming window associated within the schedulingWindow is planned to start. + + + :return: The time_next_scheduling_window_starts of this SchedulingWindow. + :rtype: datetime + """ + return self._time_next_scheduling_window_starts + + @time_next_scheduling_window_starts.setter + def time_next_scheduling_window_starts(self, time_next_scheduling_window_starts): + """ + Sets the time_next_scheduling_window_starts of this SchedulingWindow. + The date and time of the next upcoming window associated within the schedulingWindow is planned to start. + + + :param time_next_scheduling_window_starts: The time_next_scheduling_window_starts of this SchedulingWindow. + :type: datetime + """ + self._time_next_scheduling_window_starts = time_next_scheduling_window_starts + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingWindow. + The current state of the Scheduling Window. Valid states are CREATING, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingWindow. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingWindow. + The current state of the Scheduling Window. Valid states are CREATING, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingWindow. + :type: str + """ + allowed_values = ["CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingWindow. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingWindow. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingWindow. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingWindow. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this SchedulingWindow. + The date and time the Scheduling Window was created. + + + :return: The time_created of this SchedulingWindow. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingWindow. + The date and time the Scheduling Window was created. + + + :param time_created: The time_created of this SchedulingWindow. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingWindow. + The last date and time that the Scheduling Window was updated. + + + :return: The time_updated of this SchedulingWindow. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingWindow. + The last date and time that the Scheduling Window was updated. + + + :param time_updated: The time_updated of this SchedulingWindow. + :type: datetime + """ + self._time_updated = time_updated + + @property + def window_preference(self): + """ + **[Required]** Gets the window_preference of this SchedulingWindow. + + :return: The window_preference of this SchedulingWindow. + :rtype: oci.database.models.WindowPreferenceDetail + """ + return self._window_preference + + @window_preference.setter + def window_preference(self, window_preference): + """ + Sets the window_preference of this SchedulingWindow. + + :param window_preference: The window_preference of this SchedulingWindow. + :type: oci.database.models.WindowPreferenceDetail + """ + self._window_preference = window_preference + + @property + def scheduling_policy_id(self): + """ + **[Required]** Gets the scheduling_policy_id of this SchedulingWindow. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_policy_id of this SchedulingWindow. + :rtype: str + """ + return self._scheduling_policy_id + + @scheduling_policy_id.setter + def scheduling_policy_id(self, scheduling_policy_id): + """ + Sets the scheduling_policy_id of this SchedulingWindow. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_policy_id: The scheduling_policy_id of this SchedulingWindow. + :type: str + """ + self._scheduling_policy_id = scheduling_policy_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingWindow. + 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 SchedulingWindow. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingWindow. + 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 SchedulingWindow. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingWindow. + 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 SchedulingWindow. + :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 SchedulingWindow. + 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 SchedulingWindow. + :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/scheduling_window_summary.py b/src/oci/database/models/scheduling_window_summary.py new file mode 100644 index 0000000000..a09713b881 --- /dev/null +++ b/src/oci/database/models/scheduling_window_summary.py @@ -0,0 +1,469 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 SchedulingWindowSummary(object): + """ + Details of a Scheduling Window. + """ + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "AVAILABLE" + LIFECYCLE_STATE_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a SchedulingWindowSummary. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + def __init__(self, **kwargs): + """ + Initializes a new SchedulingWindowSummary 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 SchedulingWindowSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this SchedulingWindowSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this SchedulingWindowSummary. + :type display_name: str + + :param time_next_scheduling_window_starts: + The value to assign to the time_next_scheduling_window_starts property of this SchedulingWindowSummary. + :type time_next_scheduling_window_starts: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this SchedulingWindowSummary. + Allowed values for this property are: "CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", '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 SchedulingWindowSummary. + :type lifecycle_details: str + + :param time_created: + The value to assign to the time_created property of this SchedulingWindowSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this SchedulingWindowSummary. + :type time_updated: datetime + + :param window_preference: + The value to assign to the window_preference property of this SchedulingWindowSummary. + :type window_preference: oci.database.models.WindowPreferenceDetail + + :param scheduling_policy_id: + The value to assign to the scheduling_policy_id property of this SchedulingWindowSummary. + :type scheduling_policy_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this SchedulingWindowSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this SchedulingWindowSummary. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'time_next_scheduling_window_starts': 'datetime', + 'lifecycle_state': 'str', + 'lifecycle_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'window_preference': 'WindowPreferenceDetail', + 'scheduling_policy_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'time_next_scheduling_window_starts': 'timeNextSchedulingWindowStarts', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_details': 'lifecycleDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'window_preference': 'windowPreference', + 'scheduling_policy_id': 'schedulingPolicyId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._time_next_scheduling_window_starts = None + self._lifecycle_state = None + self._lifecycle_details = None + self._time_created = None + self._time_updated = None + self._window_preference = None + self._scheduling_policy_id = None + self._freeform_tags = None + self._defined_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this SchedulingWindowSummary. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this SchedulingWindowSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this SchedulingWindowSummary. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this SchedulingWindowSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this SchedulingWindowSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The compartment_id of this SchedulingWindowSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this SchedulingWindowSummary. + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param compartment_id: The compartment_id of this SchedulingWindowSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this SchedulingWindowSummary. + The user-friendly name for the Scheduling Window. The name does not need to be unique. + + + :return: The display_name of this SchedulingWindowSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this SchedulingWindowSummary. + The user-friendly name for the Scheduling Window. The name does not need to be unique. + + + :param display_name: The display_name of this SchedulingWindowSummary. + :type: str + """ + self._display_name = display_name + + @property + def time_next_scheduling_window_starts(self): + """ + Gets the time_next_scheduling_window_starts of this SchedulingWindowSummary. + The date and time of the next upcoming window associated within the schedulingWindow is planned to start. + + + :return: The time_next_scheduling_window_starts of this SchedulingWindowSummary. + :rtype: datetime + """ + return self._time_next_scheduling_window_starts + + @time_next_scheduling_window_starts.setter + def time_next_scheduling_window_starts(self, time_next_scheduling_window_starts): + """ + Sets the time_next_scheduling_window_starts of this SchedulingWindowSummary. + The date and time of the next upcoming window associated within the schedulingWindow is planned to start. + + + :param time_next_scheduling_window_starts: The time_next_scheduling_window_starts of this SchedulingWindowSummary. + :type: datetime + """ + self._time_next_scheduling_window_starts = time_next_scheduling_window_starts + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this SchedulingWindowSummary. + The current state of the Scheduling Window. Valid states are CREATING, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + Allowed values for this property are: "CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this SchedulingWindowSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this SchedulingWindowSummary. + The current state of the Scheduling Window. Valid states are CREATING, ACTIVE, UPDATING, FAILED, DELETING and DELETED. + + + :param lifecycle_state: The lifecycle_state of this SchedulingWindowSummary. + :type: str + """ + allowed_values = ["CREATING", "AVAILABLE", "UPDATING", "FAILED", "DELETING", "DELETED"] + 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 SchedulingWindowSummary. + Additional information about the current lifecycle state. + + + :return: The lifecycle_details of this SchedulingWindowSummary. + :rtype: str + """ + return self._lifecycle_details + + @lifecycle_details.setter + def lifecycle_details(self, lifecycle_details): + """ + Sets the lifecycle_details of this SchedulingWindowSummary. + Additional information about the current lifecycle state. + + + :param lifecycle_details: The lifecycle_details of this SchedulingWindowSummary. + :type: str + """ + self._lifecycle_details = lifecycle_details + + @property + def time_created(self): + """ + Gets the time_created of this SchedulingWindowSummary. + The date and time the Scheduling Window was created. + + + :return: The time_created of this SchedulingWindowSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this SchedulingWindowSummary. + The date and time the Scheduling Window was created. + + + :param time_created: The time_created of this SchedulingWindowSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this SchedulingWindowSummary. + The last date and time that the Scheduling Window was updated. + + + :return: The time_updated of this SchedulingWindowSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this SchedulingWindowSummary. + The last date and time that the Scheduling Window was updated. + + + :param time_updated: The time_updated of this SchedulingWindowSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def window_preference(self): + """ + **[Required]** Gets the window_preference of this SchedulingWindowSummary. + + :return: The window_preference of this SchedulingWindowSummary. + :rtype: oci.database.models.WindowPreferenceDetail + """ + return self._window_preference + + @window_preference.setter + def window_preference(self, window_preference): + """ + Sets the window_preference of this SchedulingWindowSummary. + + :param window_preference: The window_preference of this SchedulingWindowSummary. + :type: oci.database.models.WindowPreferenceDetail + """ + self._window_preference = window_preference + + @property + def scheduling_policy_id(self): + """ + **[Required]** Gets the scheduling_policy_id of this SchedulingWindowSummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_policy_id of this SchedulingWindowSummary. + :rtype: str + """ + return self._scheduling_policy_id + + @scheduling_policy_id.setter + def scheduling_policy_id(self, scheduling_policy_id): + """ + Sets the scheduling_policy_id of this SchedulingWindowSummary. + The `OCID`__ of the Scheduling Policy. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_policy_id: The scheduling_policy_id of this SchedulingWindowSummary. + :type: str + """ + self._scheduling_policy_id = scheduling_policy_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this SchedulingWindowSummary. + 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 SchedulingWindowSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this SchedulingWindowSummary. + 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 SchedulingWindowSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this SchedulingWindowSummary. + 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 SchedulingWindowSummary. + :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 SchedulingWindowSummary. + 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 SchedulingWindowSummary. + :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_autonomous_database_details.py b/src/oci/database/models/update_autonomous_database_details.py index f4b7f4c092..dbbe883a81 100644 --- a/src/oci/database/models/update_autonomous_database_details.py +++ b/src/oci/database/models/update_autonomous_database_details.py @@ -611,9 +611,7 @@ def long_term_backup_schedule(self, long_term_backup_schedule): def is_dev_tier(self): """ Gets the is_dev_tier of this UpdateAutonomousDatabaseDetails. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :return: The is_dev_tier of this UpdateAutonomousDatabaseDetails. @@ -625,9 +623,7 @@ def is_dev_tier(self): def is_dev_tier(self, is_dev_tier): """ Sets the is_dev_tier of this UpdateAutonomousDatabaseDetails. - Autonomous Database for Developers are free Autonomous Databases that developers can use to build and test new applications.With Autonomous these database instancess instances, you can try new Autonomous Database features for free and apply them to ongoing or new development projects. Developer database comes with limited resources and is, therefore, not suitable for large-scale testing and production deployments. When you need more compute or storage resources, you can transition to a paid database licensing by cloning your developer database into a regular Autonomous Database. See `Autonomous Database documentation`__ for more details. - - __ https://docs.oracle.com/en/cloud/paas/autonomous-database/dedicated/eddjo/index.html + Autonomous Database for Developers are fixed-shape Autonomous Databases that developers can use to build and test new applications. On Serverless, these are low-cost and billed per instance, on Dedicated and Cloud@Customer there is no additional cost to create Developer databases. Developer databases come with limited resources and is not intended for large-scale testing and production deployments. When you need more compute or storage resources, you may upgrade to a full paid production database. :param is_dev_tier: The is_dev_tier of this UpdateAutonomousDatabaseDetails. diff --git a/src/oci/database/models/update_exadb_vm_cluster_details.py b/src/oci/database/models/update_exadb_vm_cluster_details.py index bdf0dcc6c2..58ea6f0d6b 100644 --- a/src/oci/database/models/update_exadb_vm_cluster_details.py +++ b/src/oci/database/models/update_exadb_vm_cluster_details.py @@ -506,7 +506,12 @@ def system_version(self, system_version): def grid_image_id(self): """ Gets the grid_image_id of this UpdateExadbVmClusterDetails. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :return: The grid_image_id of this UpdateExadbVmClusterDetails. @@ -518,7 +523,12 @@ def grid_image_id(self): def grid_image_id(self, grid_image_id): """ Sets the grid_image_id of this UpdateExadbVmClusterDetails. - Grid Setup will be done using this grid image id + Grid Setup will be done using this grid image id. + + The grid image id can be extracted from + 1. Obtain the supported major versions using API /20160918/giVersions?compartmentId=&shape=EXADB_XS&availabilityDomain= + 2. Replace {version} with one of the supported major versions and obtain the supported minor versions using + API /20160918/giVersions/{version}/minorVersions?compartmentId=&shapeFamily=EXADB_XS&availabilityDomain= :param grid_image_id: The grid_image_id of this UpdateExadbVmClusterDetails. diff --git a/src/oci/database/models/update_execution_action_details.py b/src/oci/database/models/update_execution_action_details.py new file mode 100644 index 0000000000..cd9496dcfe --- /dev/null +++ b/src/oci/database/models/update_execution_action_details.py @@ -0,0 +1,218 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdateExecutionActionDetails(object): + """ + Describes the modification parameters for the execution action. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExecutionActionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param execution_window_id: + The value to assign to the execution_window_id property of this UpdateExecutionActionDetails. + :type execution_window_id: str + + :param action_params: + The value to assign to the action_params property of this UpdateExecutionActionDetails. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this UpdateExecutionActionDetails. + :type action_members: list[oci.database.models.ExecutionActionMember] + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExecutionActionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExecutionActionDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'execution_window_id': 'str', + 'action_params': 'dict(str, str)', + 'action_members': 'list[ExecutionActionMember]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'execution_window_id': 'executionWindowId', + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._execution_window_id = None + self._action_params = None + self._action_members = None + self._freeform_tags = None + self._defined_tags = None + + @property + def execution_window_id(self): + """ + Gets the execution_window_id of this UpdateExecutionActionDetails. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The execution_window_id of this UpdateExecutionActionDetails. + :rtype: str + """ + return self._execution_window_id + + @execution_window_id.setter + def execution_window_id(self, execution_window_id): + """ + Sets the execution_window_id of this UpdateExecutionActionDetails. + The `OCID`__ of the execution window resource the execution action belongs to. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param execution_window_id: The execution_window_id of this UpdateExecutionActionDetails. + :type: str + """ + self._execution_window_id = execution_window_id + + @property + def action_params(self): + """ + Gets the action_params of this UpdateExecutionActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this UpdateExecutionActionDetails. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this UpdateExecutionActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this UpdateExecutionActionDetails. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this UpdateExecutionActionDetails. + List of action members of this execution action. + + + :return: The action_members of this UpdateExecutionActionDetails. + :rtype: list[oci.database.models.ExecutionActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this UpdateExecutionActionDetails. + List of action members of this execution action. + + + :param action_members: The action_members of this UpdateExecutionActionDetails. + :type: list[oci.database.models.ExecutionActionMember] + """ + self._action_members = action_members + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExecutionActionDetails. + 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 UpdateExecutionActionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExecutionActionDetails. + 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 UpdateExecutionActionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExecutionActionDetails. + 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 UpdateExecutionActionDetails. + :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 UpdateExecutionActionDetails. + 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 UpdateExecutionActionDetails. + :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_execution_window_details.py b/src/oci/database/models/update_execution_window_details.py new file mode 100644 index 0000000000..c66d49fc8c --- /dev/null +++ b/src/oci/database/models/update_execution_window_details.py @@ -0,0 +1,212 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdateExecutionWindowDetails(object): + """ + Describes the modification parameters for the execution window. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateExecutionWindowDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param time_scheduled: + The value to assign to the time_scheduled property of this UpdateExecutionWindowDetails. + :type time_scheduled: datetime + + :param window_duration_in_mins: + The value to assign to the window_duration_in_mins property of this UpdateExecutionWindowDetails. + :type window_duration_in_mins: int + + :param is_enforced_duration: + The value to assign to the is_enforced_duration property of this UpdateExecutionWindowDetails. + :type is_enforced_duration: bool + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateExecutionWindowDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateExecutionWindowDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'time_scheduled': 'datetime', + 'window_duration_in_mins': 'int', + 'is_enforced_duration': 'bool', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'time_scheduled': 'timeScheduled', + 'window_duration_in_mins': 'windowDurationInMins', + 'is_enforced_duration': 'isEnforcedDuration', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._time_scheduled = None + self._window_duration_in_mins = None + self._is_enforced_duration = None + self._freeform_tags = None + self._defined_tags = None + + @property + def time_scheduled(self): + """ + Gets the time_scheduled of this UpdateExecutionWindowDetails. + The scheduled start date and time of the execution window. + + + :return: The time_scheduled of this UpdateExecutionWindowDetails. + :rtype: datetime + """ + return self._time_scheduled + + @time_scheduled.setter + def time_scheduled(self, time_scheduled): + """ + Sets the time_scheduled of this UpdateExecutionWindowDetails. + The scheduled start date and time of the execution window. + + + :param time_scheduled: The time_scheduled of this UpdateExecutionWindowDetails. + :type: datetime + """ + self._time_scheduled = time_scheduled + + @property + def window_duration_in_mins(self): + """ + Gets the window_duration_in_mins of this UpdateExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The window_duration_in_mins of this UpdateExecutionWindowDetails. + :rtype: int + """ + return self._window_duration_in_mins + + @window_duration_in_mins.setter + def window_duration_in_mins(self, window_duration_in_mins): + """ + Sets the window_duration_in_mins of this UpdateExecutionWindowDetails. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param window_duration_in_mins: The window_duration_in_mins of this UpdateExecutionWindowDetails. + :type: int + """ + self._window_duration_in_mins = window_duration_in_mins + + @property + def is_enforced_duration(self): + """ + Gets the is_enforced_duration of this UpdateExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration of this UpdateExecutionWindowDetails. + :rtype: bool + """ + return self._is_enforced_duration + + @is_enforced_duration.setter + def is_enforced_duration(self, is_enforced_duration): + """ + Sets the is_enforced_duration of this UpdateExecutionWindowDetails. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration: The is_enforced_duration of this UpdateExecutionWindowDetails. + :type: bool + """ + self._is_enforced_duration = is_enforced_duration + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateExecutionWindowDetails. + 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 UpdateExecutionWindowDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateExecutionWindowDetails. + 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 UpdateExecutionWindowDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateExecutionWindowDetails. + 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 UpdateExecutionWindowDetails. + :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 UpdateExecutionWindowDetails. + 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 UpdateExecutionWindowDetails. + :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_scheduled_action_details.py b/src/oci/database/models/update_scheduled_action_details.py new file mode 100644 index 0000000000..69f1eb95ef --- /dev/null +++ b/src/oci/database/models/update_scheduled_action_details.py @@ -0,0 +1,140 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdateScheduledActionDetails(object): + """ + Describes the modification parameters for the Scheduled Action. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateScheduledActionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param action_params: + The value to assign to the action_params property of this UpdateScheduledActionDetails. + :type action_params: dict(str, str) + + :param action_members: + The value to assign to the action_members property of this UpdateScheduledActionDetails. + :type action_members: list[oci.database.models.ActionMember] + + :param scheduling_window_id: + The value to assign to the scheduling_window_id property of this UpdateScheduledActionDetails. + :type scheduling_window_id: str + + """ + self.swagger_types = { + 'action_params': 'dict(str, str)', + 'action_members': 'list[ActionMember]', + 'scheduling_window_id': 'str' + } + + self.attribute_map = { + 'action_params': 'actionParams', + 'action_members': 'actionMembers', + 'scheduling_window_id': 'schedulingWindowId' + } + + self._action_params = None + self._action_members = None + self._scheduling_window_id = None + + @property + def action_params(self): + """ + Gets the action_params of this UpdateScheduledActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :return: The action_params of this UpdateScheduledActionDetails. + :rtype: dict(str, str) + """ + return self._action_params + + @action_params.setter + def action_params(self, action_params): + """ + Sets the action_params of this UpdateScheduledActionDetails. + Map where a key value pair describes the specific action parameter. + Example: `{\"count\": \"3\"}` + + + :param action_params: The action_params of this UpdateScheduledActionDetails. + :type: dict(str, str) + """ + self._action_params = action_params + + @property + def action_members(self): + """ + Gets the action_members of this UpdateScheduledActionDetails. + The list of action members in a scheduled action. + + + :return: The action_members of this UpdateScheduledActionDetails. + :rtype: list[oci.database.models.ActionMember] + """ + return self._action_members + + @action_members.setter + def action_members(self, action_members): + """ + Sets the action_members of this UpdateScheduledActionDetails. + The list of action members in a scheduled action. + + + :param action_members: The action_members of this UpdateScheduledActionDetails. + :type: list[oci.database.models.ActionMember] + """ + self._action_members = action_members + + @property + def scheduling_window_id(self): + """ + Gets the scheduling_window_id of this UpdateScheduledActionDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The scheduling_window_id of this UpdateScheduledActionDetails. + :rtype: str + """ + return self._scheduling_window_id + + @scheduling_window_id.setter + def scheduling_window_id(self, scheduling_window_id): + """ + Sets the scheduling_window_id of this UpdateScheduledActionDetails. + The `OCID`__ of the Scheduling Window. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param scheduling_window_id: The scheduling_window_id of this UpdateScheduledActionDetails. + :type: str + """ + self._scheduling_window_id = scheduling_window_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/update_scheduling_policy_details.py b/src/oci/database/models/update_scheduling_policy_details.py new file mode 100644 index 0000000000..309634afe4 --- /dev/null +++ b/src/oci/database/models/update_scheduling_policy_details.py @@ -0,0 +1,232 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdateSchedulingPolicyDetails(object): + """ + Describes the modification parameters for the Scheduling Policy. + """ + + #: A constant which can be used with the cadence property of a UpdateSchedulingPolicyDetails. + #: This constant has a value of "HALFYEARLY" + CADENCE_HALFYEARLY = "HALFYEARLY" + + #: A constant which can be used with the cadence property of a UpdateSchedulingPolicyDetails. + #: This constant has a value of "QUARTERLY" + CADENCE_QUARTERLY = "QUARTERLY" + + #: A constant which can be used with the cadence property of a UpdateSchedulingPolicyDetails. + #: This constant has a value of "MONTHLY" + CADENCE_MONTHLY = "MONTHLY" + + def __init__(self, **kwargs): + """ + Initializes a new UpdateSchedulingPolicyDetails 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 UpdateSchedulingPolicyDetails. + :type display_name: str + + :param cadence: + The value to assign to the cadence property of this UpdateSchedulingPolicyDetails. + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY" + :type cadence: str + + :param cadence_start_month: + The value to assign to the cadence_start_month property of this UpdateSchedulingPolicyDetails. + :type cadence_start_month: oci.database.models.Month + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateSchedulingPolicyDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateSchedulingPolicyDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'cadence': 'str', + 'cadence_start_month': 'Month', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'cadence': 'cadence', + 'cadence_start_month': 'cadenceStartMonth', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._cadence = None + self._cadence_start_month = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + Gets the display_name of this UpdateSchedulingPolicyDetails. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :return: The display_name of this UpdateSchedulingPolicyDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateSchedulingPolicyDetails. + The user-friendly name for the Scheduling Policy. The name does not need to be unique. + + + :param display_name: The display_name of this UpdateSchedulingPolicyDetails. + :type: str + """ + self._display_name = display_name + + @property + def cadence(self): + """ + Gets the cadence of this UpdateSchedulingPolicyDetails. + The cadence period. + + Allowed values for this property are: "HALFYEARLY", "QUARTERLY", "MONTHLY" + + + :return: The cadence of this UpdateSchedulingPolicyDetails. + :rtype: str + """ + return self._cadence + + @cadence.setter + def cadence(self, cadence): + """ + Sets the cadence of this UpdateSchedulingPolicyDetails. + The cadence period. + + + :param cadence: The cadence of this UpdateSchedulingPolicyDetails. + :type: str + """ + allowed_values = ["HALFYEARLY", "QUARTERLY", "MONTHLY"] + if not value_allowed_none_or_none_sentinel(cadence, allowed_values): + raise ValueError( + f"Invalid value for `cadence`, must be None or one of {allowed_values}" + ) + self._cadence = cadence + + @property + def cadence_start_month(self): + """ + Gets the cadence_start_month of this UpdateSchedulingPolicyDetails. + Start of the month to be followed during the cadence period. + + + :return: The cadence_start_month of this UpdateSchedulingPolicyDetails. + :rtype: oci.database.models.Month + """ + return self._cadence_start_month + + @cadence_start_month.setter + def cadence_start_month(self, cadence_start_month): + """ + Sets the cadence_start_month of this UpdateSchedulingPolicyDetails. + Start of the month to be followed during the cadence period. + + + :param cadence_start_month: The cadence_start_month of this UpdateSchedulingPolicyDetails. + :type: oci.database.models.Month + """ + self._cadence_start_month = cadence_start_month + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateSchedulingPolicyDetails. + 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 UpdateSchedulingPolicyDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateSchedulingPolicyDetails. + 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 UpdateSchedulingPolicyDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateSchedulingPolicyDetails. + 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 UpdateSchedulingPolicyDetails. + :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 UpdateSchedulingPolicyDetails. + 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 UpdateSchedulingPolicyDetails. + :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_scheduling_window_details.py b/src/oci/database/models/update_scheduling_window_details.py new file mode 100644 index 0000000000..46256791fe --- /dev/null +++ b/src/oci/database/models/update_scheduling_window_details.py @@ -0,0 +1,146 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdateSchedulingWindowDetails(object): + """ + Describes the modification parameters for the Scheduling Window. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateSchedulingWindowDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param window_preference: + The value to assign to the window_preference property of this UpdateSchedulingWindowDetails. + :type window_preference: oci.database.models.WindowPreferenceDetail + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateSchedulingWindowDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateSchedulingWindowDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'window_preference': 'WindowPreferenceDetail', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'window_preference': 'windowPreference', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._window_preference = None + self._freeform_tags = None + self._defined_tags = None + + @property + def window_preference(self): + """ + Gets the window_preference of this UpdateSchedulingWindowDetails. + + :return: The window_preference of this UpdateSchedulingWindowDetails. + :rtype: oci.database.models.WindowPreferenceDetail + """ + return self._window_preference + + @window_preference.setter + def window_preference(self, window_preference): + """ + Sets the window_preference of this UpdateSchedulingWindowDetails. + + :param window_preference: The window_preference of this UpdateSchedulingWindowDetails. + :type: oci.database.models.WindowPreferenceDetail + """ + self._window_preference = window_preference + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateSchedulingWindowDetails. + 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 UpdateSchedulingWindowDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateSchedulingWindowDetails. + 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 UpdateSchedulingWindowDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateSchedulingWindowDetails. + 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 UpdateSchedulingWindowDetails. + :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 UpdateSchedulingWindowDetails. + 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 UpdateSchedulingWindowDetails. + :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/window_preference_detail.py b/src/oci/database/models/window_preference_detail.py new file mode 100644 index 0000000000..cd594aa0bf --- /dev/null +++ b/src/oci/database/models/window_preference_detail.py @@ -0,0 +1,231 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 WindowPreferenceDetail(object): + """ + The Single Scheduling Window details. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WindowPreferenceDetail object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param months: + The value to assign to the months property of this WindowPreferenceDetail. + :type months: list[oci.database.models.Month] + + :param weeks_of_month: + The value to assign to the weeks_of_month property of this WindowPreferenceDetail. + :type weeks_of_month: list[int] + + :param days_of_week: + The value to assign to the days_of_week property of this WindowPreferenceDetail. + :type days_of_week: list[oci.database.models.DayOfWeek] + + :param start_time: + The value to assign to the start_time property of this WindowPreferenceDetail. + :type start_time: str + + :param duration: + The value to assign to the duration property of this WindowPreferenceDetail. + :type duration: int + + :param is_enforced_duration: + The value to assign to the is_enforced_duration property of this WindowPreferenceDetail. + :type is_enforced_duration: bool + + """ + self.swagger_types = { + 'months': 'list[Month]', + 'weeks_of_month': 'list[int]', + 'days_of_week': 'list[DayOfWeek]', + 'start_time': 'str', + 'duration': 'int', + 'is_enforced_duration': 'bool' + } + + self.attribute_map = { + 'months': 'months', + 'weeks_of_month': 'weeksOfMonth', + 'days_of_week': 'daysOfWeek', + 'start_time': 'startTime', + 'duration': 'duration', + 'is_enforced_duration': 'isEnforcedDuration' + } + + self._months = None + self._weeks_of_month = None + self._days_of_week = None + self._start_time = None + self._duration = None + self._is_enforced_duration = None + + @property + def months(self): + """ + Gets the months of this WindowPreferenceDetail. + Months during the year when scheduled window should be performed. + + + :return: The months of this WindowPreferenceDetail. + :rtype: list[oci.database.models.Month] + """ + return self._months + + @months.setter + def months(self, months): + """ + Sets the months of this WindowPreferenceDetail. + Months during the year when scheduled window should be performed. + + + :param months: The months of this WindowPreferenceDetail. + :type: list[oci.database.models.Month] + """ + self._months = months + + @property + def weeks_of_month(self): + """ + **[Required]** Gets the weeks_of_month of this WindowPreferenceDetail. + Weeks during the month when scheduled window should be performed. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and have a duration of 7 days. Weeks start and end based on calendar dates, not days of the week. + For example, to allow scheduling window during the 2nd week of the month (from the 8th day to the 14th day of the month), use the value 2. Scheduling window cannot be scheduled for the fifth week of months that contain more than 28 days. + Note that this parameter works in conjunction with the daysOfWeek and startTime parameters to allow you to specify specific days of the week and hours that scheduled window will be performed. + + + :return: The weeks_of_month of this WindowPreferenceDetail. + :rtype: list[int] + """ + return self._weeks_of_month + + @weeks_of_month.setter + def weeks_of_month(self, weeks_of_month): + """ + Sets the weeks_of_month of this WindowPreferenceDetail. + Weeks during the month when scheduled window should be performed. Weeks start on the 1st, 8th, 15th, and 22nd days of the month, and have a duration of 7 days. Weeks start and end based on calendar dates, not days of the week. + For example, to allow scheduling window during the 2nd week of the month (from the 8th day to the 14th day of the month), use the value 2. Scheduling window cannot be scheduled for the fifth week of months that contain more than 28 days. + Note that this parameter works in conjunction with the daysOfWeek and startTime parameters to allow you to specify specific days of the week and hours that scheduled window will be performed. + + + :param weeks_of_month: The weeks_of_month of this WindowPreferenceDetail. + :type: list[int] + """ + self._weeks_of_month = weeks_of_month + + @property + def days_of_week(self): + """ + **[Required]** Gets the days_of_week of this WindowPreferenceDetail. + Days during the week when scheduling window should be performed. + + + :return: The days_of_week of this WindowPreferenceDetail. + :rtype: list[oci.database.models.DayOfWeek] + """ + return self._days_of_week + + @days_of_week.setter + def days_of_week(self, days_of_week): + """ + Sets the days_of_week of this WindowPreferenceDetail. + Days during the week when scheduling window should be performed. + + + :param days_of_week: The days_of_week of this WindowPreferenceDetail. + :type: list[oci.database.models.DayOfWeek] + """ + self._days_of_week = days_of_week + + @property + def start_time(self): + """ + **[Required]** Gets the start_time of this WindowPreferenceDetail. + The scheduling window start time. The value must use the ISO-8601 format \"hh:mm\". + + + :return: The start_time of this WindowPreferenceDetail. + :rtype: str + """ + return self._start_time + + @start_time.setter + def start_time(self, start_time): + """ + Sets the start_time of this WindowPreferenceDetail. + The scheduling window start time. The value must use the ISO-8601 format \"hh:mm\". + + + :param start_time: The start_time of this WindowPreferenceDetail. + :type: str + """ + self._start_time = start_time + + @property + def duration(self): + """ + **[Required]** Gets the duration of this WindowPreferenceDetail. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :return: The duration of this WindowPreferenceDetail. + :rtype: int + """ + return self._duration + + @duration.setter + def duration(self, duration): + """ + Sets the duration of this WindowPreferenceDetail. + Duration window allows user to set a duration they plan to allocate for Scheduling window. The duration is in minutes. + + + :param duration: The duration of this WindowPreferenceDetail. + :type: int + """ + self._duration = duration + + @property + def is_enforced_duration(self): + """ + **[Required]** Gets the is_enforced_duration of this WindowPreferenceDetail. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :return: The is_enforced_duration of this WindowPreferenceDetail. + :rtype: bool + """ + return self._is_enforced_duration + + @is_enforced_duration.setter + def is_enforced_duration(self, is_enforced_duration): + """ + Sets the is_enforced_duration of this WindowPreferenceDetail. + Indicates if duration the user plans to allocate for scheduling window is strictly enforced. The default value is `FALSE`. + + + :param is_enforced_duration: The is_enforced_duration of this WindowPreferenceDetail. + :type: bool + """ + self._is_enforced_duration = is_enforced_duration + + 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_management/db_management_client.py b/src/oci/database_management/db_management_client.py index 6108078443..ba3374433c 100644 --- a/src/oci/database_management/db_management_client.py +++ b/src/oci/database_management/db_management_client.py @@ -4360,6 +4360,128 @@ def disable_automatic_spm_evolve_advisor_task(self, managed_database_id, disable api_reference_link=api_reference_link, required_arguments=required_arguments) + def disable_autonomous_database_management_feature(self, autonomous_database_id, disable_autonomous_database_management_feature_details, **kwargs): + """ + Disables a Database Management feature for the specified Autonomous Database. + + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails disable_autonomous_database_management_feature_details: (required) + The details required to disable a Database Management feature for an Autonomous Database. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 + might 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 disable_autonomous_database_management_feature API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/disableDatabaseManagement" + method = "POST" + operation_name = "disable_autonomous_database_management_feature" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database-management/20201101/ManagedDatabase/DisableAutonomousDatabaseManagementFeature" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"disable_autonomous_database_management_feature got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=disable_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=disable_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def disable_database_management_feature(self, database_id, disable_database_management_feature_details, **kwargs): """ Disables a Database Management feature for the specified Oracle cloud database. @@ -6101,6 +6223,128 @@ def enable_automatic_spm_evolve_advisor_task(self, managed_database_id, enable_a api_reference_link=api_reference_link, required_arguments=required_arguments) + def enable_autonomous_database_management_feature(self, autonomous_database_id, enable_autonomous_database_management_feature_details, **kwargs): + """ + Enables a Database Management feature for the specified Autonomous Database. + + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails enable_autonomous_database_management_feature_details: (required) + The details required to enable a Database Management feature for an Autonomous Database. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 + might 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 enable_autonomous_database_management_feature API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/enableDatabaseManagement" + method = "POST" + operation_name = "enable_autonomous_database_management_feature" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database-management/20201101/ManagedDatabase/EnableAutonomousDatabaseManagementFeature" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"enable_autonomous_database_management_feature got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=enable_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=enable_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def enable_database_management_feature(self, database_id, enable_database_management_feature_details, **kwargs): """ Enables a Database Management feature for the specified cloud database. @@ -13519,6 +13763,10 @@ def list_db_management_private_endpoints(self, compartment_id, **kwargs): :param bool is_cluster: (optional) The option to filter Database Management private endpoints that can used for Oracle Databases in a cluster. This should be used along with the vcnId query parameter. + :param bool is_dns_resolution_enabled: (optional) + The option to filter Database Management private endpoints which are endbled with DNS proxy server. This should be used along with the vcnId query parameter. + Only one of this parameter and IsClusterDbManagementPrivateEndpointQueryParam should be set to true at one time. + :param str lifecycle_state: (optional) The lifecycle state of a resource. @@ -13578,6 +13826,7 @@ def list_db_management_private_endpoints(self, compartment_id, **kwargs): "name", "vcn_id", "is_cluster", + "is_dns_resolution_enabled", "lifecycle_state", "limit", "page", @@ -13616,6 +13865,7 @@ def list_db_management_private_endpoints(self, compartment_id, **kwargs): "name": kwargs.get("name", missing), "vcnId": kwargs.get("vcn_id", missing), "isCluster": kwargs.get("is_cluster", missing), + "isDnsResolutionEnabled": kwargs.get("is_dns_resolution_enabled", missing), "lifecycleState": kwargs.get("lifecycle_state", missing), "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), @@ -20053,6 +20303,128 @@ def load_sql_plan_baselines_from_cursor_cache(self, managed_database_id, load_sq api_reference_link=api_reference_link, required_arguments=required_arguments) + def modify_autonomous_database_management_feature(self, autonomous_database_id, modify_autonomous_database_management_feature_details, **kwargs): + """ + Modifies the Database Management feature for the specified Autonomous Database. + + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails modify_autonomous_database_management_feature_details: (required) + The details required to modify a Database Management feature for an Autonomous Database. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :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 + might 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 modify_autonomous_database_management_feature API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['autonomousDatabaseId'] + resource_path = "/autonomousDatabases/{autonomousDatabaseId}/actions/modifyDatabaseManagement" + method = "POST" + operation_name = "modify_autonomous_database_management_feature" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/database-management/20201101/ManagedDatabase/ModifyAutonomousDatabaseManagementFeature" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"modify_autonomous_database_management_feature got unknown kwargs: {extra_kwargs!r}") + + 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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=modify_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=modify_autonomous_database_management_feature_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def modify_database_management_feature(self, database_id, modify_database_management_feature_details, **kwargs): """ Modifies a Database Management feature for the specified Oracle cloud database. diff --git a/src/oci/database_management/db_management_client_composite_operations.py b/src/oci/database_management/db_management_client_composite_operations.py index c9742024db..f94898b90f 100644 --- a/src/oci/database_management/db_management_client_composite_operations.py +++ b/src/oci/database_management/db_management_client_composite_operations.py @@ -1039,6 +1039,50 @@ def delete_named_credential_and_wait_for_state(self, named_credential_id, wait_f except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def disable_autonomous_database_management_feature_and_wait_for_state(self, autonomous_database_id, disable_autonomous_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database_management.DbManagementClient.disable_autonomous_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` + to enter the given state(s). + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.DisableAutonomousDatabaseManagementFeatureDetails disable_autonomous_database_management_feature_details: (required) + The details required to disable a Database Management feature for 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_management.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database_management.DbManagementClient.disable_autonomous_database_management_feature` + + :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_management_feature(autonomous_database_id, disable_autonomous_database_management_feature_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 disable_database_management_feature_and_wait_for_state(self, database_id, disable_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database_management.DbManagementClient.disable_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` @@ -1382,6 +1426,50 @@ def disable_pluggable_database_management_feature_and_wait_for_state(self, plugg except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def enable_autonomous_database_management_feature_and_wait_for_state(self, autonomous_database_id, enable_autonomous_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database_management.DbManagementClient.enable_autonomous_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` + to enter the given state(s). + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.EnableAutonomousDatabaseManagementFeatureDetails enable_autonomous_database_management_feature_details: (required) + The details required to enable a Database Management feature for 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_management.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database_management.DbManagementClient.enable_autonomous_database_management_feature` + + :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_management_feature(autonomous_database_id, enable_autonomous_database_management_feature_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 enable_database_management_feature_and_wait_for_state(self, database_id, enable_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database_management.DbManagementClient.enable_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` @@ -1734,6 +1822,50 @@ def enable_pluggable_database_management_feature_and_wait_for_state(self, plugga except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def modify_autonomous_database_management_feature_and_wait_for_state(self, autonomous_database_id, modify_autonomous_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.database_management.DbManagementClient.modify_autonomous_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` + to enter the given state(s). + + :param str autonomous_database_id: (required) + The `OCID`__ of the Autonomous Database. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.database_management.models.ModifyAutonomousDatabaseManagementFeatureDetails modify_autonomous_database_management_feature_details: (required) + The details required to modify a Database Management feature for 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_management.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.database_management.DbManagementClient.modify_autonomous_database_management_feature` + + :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.modify_autonomous_database_management_feature(autonomous_database_id, modify_autonomous_database_management_feature_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 modify_database_management_feature_and_wait_for_state(self, database_id, modify_database_management_feature_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.database_management.DbManagementClient.modify_database_management_feature` and waits for the :py:class:`~oci.database_management.models.WorkRequest` diff --git a/src/oci/database_management/models/__init__.py b/src/oci/database_management/models/__init__.py index cff57dbc64..25b847712e 100644 --- a/src/oci/database_management/models/__init__.py +++ b/src/oci/database_management/models/__init__.py @@ -34,6 +34,9 @@ from .attention_log_summary import AttentionLogSummary from .automatic_capture_filter import AutomaticCaptureFilter from .automatic_capture_filter_details import AutomaticCaptureFilterDetails +from .autonomous_database_diagnostics_and_management_feature_details import AutonomousDatabaseDiagnosticsAndManagementFeatureDetails +from .autonomous_database_feature_details import AutonomousDatabaseFeatureDetails +from .autonomous_database_sql_watch_feature_details import AutonomousDatabaseSqlWatchFeatureDetails from .awr_db_collection import AwrDbCollection from .awr_db_cpu_usage_collection import AwrDbCpuUsageCollection from .awr_db_cpu_usage_summary import AwrDbCpuUsageSummary @@ -142,8 +145,10 @@ from .db_management_private_endpoint_collection import DbManagementPrivateEndpointCollection from .db_management_private_endpoint_summary import DbManagementPrivateEndpointSummary from .dbm_resource import DbmResource +from .direct_connector_details import DirectConnectorDetails from .disable_automatic_initial_plan_capture_details import DisableAutomaticInitialPlanCaptureDetails from .disable_automatic_spm_evolve_advisor_task_details import DisableAutomaticSpmEvolveAdvisorTaskDetails +from .disable_autonomous_database_management_feature_details import DisableAutonomousDatabaseManagementFeatureDetails from .disable_database_management_feature_details import DisableDatabaseManagementFeatureDetails from .disable_external_container_database_management_feature_details import DisableExternalContainerDatabaseManagementFeatureDetails from .disable_external_non_container_database_management_feature_details import DisableExternalNonContainerDatabaseManagementFeatureDetails @@ -169,6 +174,7 @@ from .drop_tablespace_details import DropTablespaceDetails from .enable_automatic_initial_plan_capture_details import EnableAutomaticInitialPlanCaptureDetails from .enable_automatic_spm_evolve_advisor_task_details import EnableAutomaticSpmEvolveAdvisorTaskDetails +from .enable_autonomous_database_management_feature_details import EnableAutonomousDatabaseManagementFeatureDetails from .enable_database_management_feature_details import EnableDatabaseManagementFeatureDetails from .enable_external_container_database_management_feature_details import EnableExternalContainerDatabaseManagementFeatureDetails from .enable_external_db_system_database_management_details import EnableExternalDbSystemDatabaseManagementDetails @@ -330,6 +336,7 @@ from .metric_statistics_definition import MetricStatisticsDefinition from .metrics_aggregation_range import MetricsAggregationRange from .metrics_aggregation_range_collection import MetricsAggregationRangeCollection +from .modify_autonomous_database_management_feature_details import ModifyAutonomousDatabaseManagementFeatureDetails from .modify_database_management_feature_details import ModifyDatabaseManagementFeatureDetails from .modify_pluggable_database_management_feature_details import ModifyPluggableDatabaseManagementFeatureDetails from .modify_snapshot_settings_details import ModifySnapshotSettingsDetails @@ -537,6 +544,9 @@ "AttentionLogSummary": AttentionLogSummary, "AutomaticCaptureFilter": AutomaticCaptureFilter, "AutomaticCaptureFilterDetails": AutomaticCaptureFilterDetails, + "AutonomousDatabaseDiagnosticsAndManagementFeatureDetails": AutonomousDatabaseDiagnosticsAndManagementFeatureDetails, + "AutonomousDatabaseFeatureDetails": AutonomousDatabaseFeatureDetails, + "AutonomousDatabaseSqlWatchFeatureDetails": AutonomousDatabaseSqlWatchFeatureDetails, "AwrDbCollection": AwrDbCollection, "AwrDbCpuUsageCollection": AwrDbCpuUsageCollection, "AwrDbCpuUsageSummary": AwrDbCpuUsageSummary, @@ -645,8 +655,10 @@ "DbManagementPrivateEndpointCollection": DbManagementPrivateEndpointCollection, "DbManagementPrivateEndpointSummary": DbManagementPrivateEndpointSummary, "DbmResource": DbmResource, + "DirectConnectorDetails": DirectConnectorDetails, "DisableAutomaticInitialPlanCaptureDetails": DisableAutomaticInitialPlanCaptureDetails, "DisableAutomaticSpmEvolveAdvisorTaskDetails": DisableAutomaticSpmEvolveAdvisorTaskDetails, + "DisableAutonomousDatabaseManagementFeatureDetails": DisableAutonomousDatabaseManagementFeatureDetails, "DisableDatabaseManagementFeatureDetails": DisableDatabaseManagementFeatureDetails, "DisableExternalContainerDatabaseManagementFeatureDetails": DisableExternalContainerDatabaseManagementFeatureDetails, "DisableExternalNonContainerDatabaseManagementFeatureDetails": DisableExternalNonContainerDatabaseManagementFeatureDetails, @@ -672,6 +684,7 @@ "DropTablespaceDetails": DropTablespaceDetails, "EnableAutomaticInitialPlanCaptureDetails": EnableAutomaticInitialPlanCaptureDetails, "EnableAutomaticSpmEvolveAdvisorTaskDetails": EnableAutomaticSpmEvolveAdvisorTaskDetails, + "EnableAutonomousDatabaseManagementFeatureDetails": EnableAutonomousDatabaseManagementFeatureDetails, "EnableDatabaseManagementFeatureDetails": EnableDatabaseManagementFeatureDetails, "EnableExternalContainerDatabaseManagementFeatureDetails": EnableExternalContainerDatabaseManagementFeatureDetails, "EnableExternalDbSystemDatabaseManagementDetails": EnableExternalDbSystemDatabaseManagementDetails, @@ -833,6 +846,7 @@ "MetricStatisticsDefinition": MetricStatisticsDefinition, "MetricsAggregationRange": MetricsAggregationRange, "MetricsAggregationRangeCollection": MetricsAggregationRangeCollection, + "ModifyAutonomousDatabaseManagementFeatureDetails": ModifyAutonomousDatabaseManagementFeatureDetails, "ModifyDatabaseManagementFeatureDetails": ModifyDatabaseManagementFeatureDetails, "ModifyPluggableDatabaseManagementFeatureDetails": ModifyPluggableDatabaseManagementFeatureDetails, "ModifySnapshotSettingsDetails": ModifySnapshotSettingsDetails, diff --git a/src/oci/database_management/models/autonomous_database_diagnostics_and_management_feature_details.py b/src/oci/database_management/models/autonomous_database_diagnostics_and_management_feature_details.py new file mode 100644 index 0000000000..9785af5c69 --- /dev/null +++ b/src/oci/database_management/models/autonomous_database_diagnostics_and_management_feature_details.py @@ -0,0 +1,65 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + +from .autonomous_database_feature_details import AutonomousDatabaseFeatureDetails +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 AutonomousDatabaseDiagnosticsAndManagementFeatureDetails(AutonomousDatabaseFeatureDetails): + """ + The details required to enable the Diagnostics and Management feature. + """ + + def __init__(self, **kwargs): + """ + Initializes a new AutonomousDatabaseDiagnosticsAndManagementFeatureDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails.feature` attribute + of this class is ``DIAGNOSTICS_AND_MANAGEMENT`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature: + The value to assign to the feature property of this AutonomousDatabaseDiagnosticsAndManagementFeatureDetails. + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + :type feature: str + + :param database_connection_details: + The value to assign to the database_connection_details property of this AutonomousDatabaseDiagnosticsAndManagementFeatureDetails. + :type database_connection_details: oci.database_management.models.DatabaseConnectionDetails + + :param connector_details: + The value to assign to the connector_details property of this AutonomousDatabaseDiagnosticsAndManagementFeatureDetails. + :type connector_details: oci.database_management.models.ConnectorDetails + + """ + self.swagger_types = { + 'feature': 'str', + 'database_connection_details': 'DatabaseConnectionDetails', + 'connector_details': 'ConnectorDetails' + } + + self.attribute_map = { + 'feature': 'feature', + 'database_connection_details': 'databaseConnectionDetails', + 'connector_details': 'connectorDetails' + } + + self._feature = None + self._database_connection_details = None + self._connector_details = None + self._feature = 'DIAGNOSTICS_AND_MANAGEMENT' + + 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_management/models/autonomous_database_feature_details.py b/src/oci/database_management/models/autonomous_database_feature_details.py new file mode 100644 index 0000000000..9560ef6c72 --- /dev/null +++ b/src/oci/database_management/models/autonomous_database_feature_details.py @@ -0,0 +1,167 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + + +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 AutonomousDatabaseFeatureDetails(object): + """ + The details required to enable the specified Database Management feature for an Autonomous Database. + """ + + #: A constant which can be used with the feature property of a AutonomousDatabaseFeatureDetails. + #: This constant has a value of "DIAGNOSTICS_AND_MANAGEMENT" + FEATURE_DIAGNOSTICS_AND_MANAGEMENT = "DIAGNOSTICS_AND_MANAGEMENT" + + #: A constant which can be used with the feature property of a AutonomousDatabaseFeatureDetails. + #: This constant has a value of "DB_LIFECYCLE_MANAGEMENT" + FEATURE_DB_LIFECYCLE_MANAGEMENT = "DB_LIFECYCLE_MANAGEMENT" + + #: A constant which can be used with the feature property of a AutonomousDatabaseFeatureDetails. + #: This constant has a value of "SQLWATCH" + FEATURE_SQLWATCH = "SQLWATCH" + + def __init__(self, **kwargs): + """ + Initializes a new AutonomousDatabaseFeatureDetails 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_management.models.AutonomousDatabaseSqlWatchFeatureDetails` + * :class:`~oci.database_management.models.AutonomousDatabaseDiagnosticsAndManagementFeatureDetails` + + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature: + The value to assign to the feature property of this AutonomousDatabaseFeatureDetails. + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + :type feature: str + + :param database_connection_details: + The value to assign to the database_connection_details property of this AutonomousDatabaseFeatureDetails. + :type database_connection_details: oci.database_management.models.DatabaseConnectionDetails + + :param connector_details: + The value to assign to the connector_details property of this AutonomousDatabaseFeatureDetails. + :type connector_details: oci.database_management.models.ConnectorDetails + + """ + self.swagger_types = { + 'feature': 'str', + 'database_connection_details': 'DatabaseConnectionDetails', + 'connector_details': 'ConnectorDetails' + } + + self.attribute_map = { + 'feature': 'feature', + 'database_connection_details': 'databaseConnectionDetails', + 'connector_details': 'connectorDetails' + } + + self._feature = None + self._database_connection_details = None + self._connector_details = 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['feature'] + + if type == 'SQLWATCH': + return 'AutonomousDatabaseSqlWatchFeatureDetails' + + if type == 'DIAGNOSTICS_AND_MANAGEMENT': + return 'AutonomousDatabaseDiagnosticsAndManagementFeatureDetails' + else: + return 'AutonomousDatabaseFeatureDetails' + + @property + def feature(self): + """ + **[Required]** Gets the feature of this AutonomousDatabaseFeatureDetails. + The name of the Database Management feature. + + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + + + :return: The feature of this AutonomousDatabaseFeatureDetails. + :rtype: str + """ + return self._feature + + @feature.setter + def feature(self, feature): + """ + Sets the feature of this AutonomousDatabaseFeatureDetails. + The name of the Database Management feature. + + + :param feature: The feature of this AutonomousDatabaseFeatureDetails. + :type: str + """ + allowed_values = ["DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH"] + if not value_allowed_none_or_none_sentinel(feature, allowed_values): + raise ValueError( + f"Invalid value for `feature`, must be None or one of {allowed_values}" + ) + self._feature = feature + + @property + def database_connection_details(self): + """ + **[Required]** Gets the database_connection_details of this AutonomousDatabaseFeatureDetails. + + :return: The database_connection_details of this AutonomousDatabaseFeatureDetails. + :rtype: oci.database_management.models.DatabaseConnectionDetails + """ + return self._database_connection_details + + @database_connection_details.setter + def database_connection_details(self, database_connection_details): + """ + Sets the database_connection_details of this AutonomousDatabaseFeatureDetails. + + :param database_connection_details: The database_connection_details of this AutonomousDatabaseFeatureDetails. + :type: oci.database_management.models.DatabaseConnectionDetails + """ + self._database_connection_details = database_connection_details + + @property + def connector_details(self): + """ + Gets the connector_details of this AutonomousDatabaseFeatureDetails. + + :return: The connector_details of this AutonomousDatabaseFeatureDetails. + :rtype: oci.database_management.models.ConnectorDetails + """ + return self._connector_details + + @connector_details.setter + def connector_details(self, connector_details): + """ + Sets the connector_details of this AutonomousDatabaseFeatureDetails. + + :param connector_details: The connector_details of this AutonomousDatabaseFeatureDetails. + :type: oci.database_management.models.ConnectorDetails + """ + self._connector_details = connector_details + + 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_management/models/autonomous_database_sql_watch_feature_details.py b/src/oci/database_management/models/autonomous_database_sql_watch_feature_details.py new file mode 100644 index 0000000000..929b8ea0c0 --- /dev/null +++ b/src/oci/database_management/models/autonomous_database_sql_watch_feature_details.py @@ -0,0 +1,65 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + +from .autonomous_database_feature_details import AutonomousDatabaseFeatureDetails +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 AutonomousDatabaseSqlWatchFeatureDetails(AutonomousDatabaseFeatureDetails): + """ + The details required to enable the SQL Watch feature. + """ + + def __init__(self, **kwargs): + """ + Initializes a new AutonomousDatabaseSqlWatchFeatureDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database_management.models.AutonomousDatabaseSqlWatchFeatureDetails.feature` attribute + of this class is ``SQLWATCH`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature: + The value to assign to the feature property of this AutonomousDatabaseSqlWatchFeatureDetails. + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + :type feature: str + + :param database_connection_details: + The value to assign to the database_connection_details property of this AutonomousDatabaseSqlWatchFeatureDetails. + :type database_connection_details: oci.database_management.models.DatabaseConnectionDetails + + :param connector_details: + The value to assign to the connector_details property of this AutonomousDatabaseSqlWatchFeatureDetails. + :type connector_details: oci.database_management.models.ConnectorDetails + + """ + self.swagger_types = { + 'feature': 'str', + 'database_connection_details': 'DatabaseConnectionDetails', + 'connector_details': 'ConnectorDetails' + } + + self.attribute_map = { + 'feature': 'feature', + 'database_connection_details': 'databaseConnectionDetails', + 'connector_details': 'connectorDetails' + } + + self._feature = None + self._database_connection_details = None + self._connector_details = None + self._feature = 'SQLWATCH' + + 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_management/models/connector_details.py b/src/oci/database_management/models/connector_details.py index e6f33f2823..7525cdec41 100644 --- a/src/oci/database_management/models/connector_details.py +++ b/src/oci/database_management/models/connector_details.py @@ -27,12 +27,17 @@ class ConnectorDetails(object): #: This constant has a value of "EXTERNAL" CONNECTOR_TYPE_EXTERNAL = "EXTERNAL" + #: A constant which can be used with the connector_type property of a ConnectorDetails. + #: This constant has a value of "DIRECT" + CONNECTOR_TYPE_DIRECT = "DIRECT" + def __init__(self, **kwargs): """ Initializes a new ConnectorDetails 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_management.models.ExternalConnectorDetails` + * :class:`~oci.database_management.models.DirectConnectorDetails` * :class:`~oci.database_management.models.MacsConnectorDetails` * :class:`~oci.database_management.models.PrivateEndPointConnectorDetails` @@ -40,7 +45,7 @@ def __init__(self, **kwargs): :param connector_type: The value to assign to the connector_type property of this ConnectorDetails. - Allowed values for this property are: "PE", "MACS", "EXTERNAL", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type connector_type: str @@ -66,6 +71,9 @@ def get_subtype(object_dictionary): if type == 'EXTERNAL': return 'ExternalConnectorDetails' + if type == 'DIRECT': + return 'DirectConnectorDetails' + if type == 'MACS': return 'MacsConnectorDetails' @@ -83,7 +91,9 @@ def connector_type(self): - MACS: Management agent - EXTERNAL: External database connector - Allowed values for this property are: "PE", "MACS", "EXTERNAL", 'UNKNOWN_ENUM_VALUE'. + - DIRECT: Direct connection + + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -101,11 +111,13 @@ def connector_type(self, connector_type): - MACS: Management agent - EXTERNAL: External database connector + - DIRECT: Direct connection + :param connector_type: The connector_type of this ConnectorDetails. :type: str """ - allowed_values = ["PE", "MACS", "EXTERNAL"] + allowed_values = ["PE", "MACS", "EXTERNAL", "DIRECT"] if not value_allowed_none_or_none_sentinel(connector_type, allowed_values): connector_type = 'UNKNOWN_ENUM_VALUE' self._connector_type = connector_type diff --git a/src/oci/database_management/models/create_db_management_private_endpoint_details.py b/src/oci/database_management/models/create_db_management_private_endpoint_details.py index 3cdd2877a7..36c54a6d78 100644 --- a/src/oci/database_management/models/create_db_management_private_endpoint_details.py +++ b/src/oci/database_management/models/create_db_management_private_endpoint_details.py @@ -32,6 +32,10 @@ def __init__(self, **kwargs): The value to assign to the is_cluster property of this CreateDbManagementPrivateEndpointDetails. :type is_cluster: bool + :param is_dns_resolution_enabled: + The value to assign to the is_dns_resolution_enabled property of this CreateDbManagementPrivateEndpointDetails. + :type is_dns_resolution_enabled: bool + :param subnet_id: The value to assign to the subnet_id property of this CreateDbManagementPrivateEndpointDetails. :type subnet_id: str @@ -57,6 +61,7 @@ def __init__(self, **kwargs): 'name': 'str', 'compartment_id': 'str', 'is_cluster': 'bool', + 'is_dns_resolution_enabled': 'bool', 'subnet_id': 'str', 'description': 'str', 'nsg_ids': 'list[str]', @@ -68,6 +73,7 @@ def __init__(self, **kwargs): 'name': 'name', 'compartment_id': 'compartmentId', 'is_cluster': 'isCluster', + 'is_dns_resolution_enabled': 'isDnsResolutionEnabled', 'subnet_id': 'subnetId', 'description': 'description', 'nsg_ids': 'nsgIds', @@ -78,6 +84,7 @@ def __init__(self, **kwargs): self._name = None self._compartment_id = None self._is_cluster = None + self._is_dns_resolution_enabled = None self._subnet_id = None self._description = None self._nsg_ids = None @@ -160,6 +167,30 @@ def is_cluster(self, is_cluster): """ self._is_cluster = is_cluster + @property + def is_dns_resolution_enabled(self): + """ + Gets the is_dns_resolution_enabled of this CreateDbManagementPrivateEndpointDetails. + Specifies whether the Database Management private endpoint has DNS proxy server enabled to resolve private host name. + + + :return: The is_dns_resolution_enabled of this CreateDbManagementPrivateEndpointDetails. + :rtype: bool + """ + return self._is_dns_resolution_enabled + + @is_dns_resolution_enabled.setter + def is_dns_resolution_enabled(self, is_dns_resolution_enabled): + """ + Sets the is_dns_resolution_enabled of this CreateDbManagementPrivateEndpointDetails. + Specifies whether the Database Management private endpoint has DNS proxy server enabled to resolve private host name. + + + :param is_dns_resolution_enabled: The is_dns_resolution_enabled of this CreateDbManagementPrivateEndpointDetails. + :type: bool + """ + self._is_dns_resolution_enabled = is_dns_resolution_enabled + @property def subnet_id(self): """ diff --git a/src/oci/database_management/models/db_management_private_endpoint.py b/src/oci/database_management/models/db_management_private_endpoint.py index bb0b79dfa7..a38f8c9ab0 100644 --- a/src/oci/database_management/models/db_management_private_endpoint.py +++ b/src/oci/database_management/models/db_management_private_endpoint.py @@ -60,6 +60,10 @@ def __init__(self, **kwargs): The value to assign to the is_cluster property of this DbManagementPrivateEndpoint. :type is_cluster: bool + :param is_dns_resolution_enabled: + The value to assign to the is_dns_resolution_enabled property of this DbManagementPrivateEndpoint. + :type is_dns_resolution_enabled: bool + :param vcn_id: The value to assign to the vcn_id property of this DbManagementPrivateEndpoint. :type vcn_id: str @@ -108,6 +112,7 @@ def __init__(self, **kwargs): 'name': 'str', 'compartment_id': 'str', 'is_cluster': 'bool', + 'is_dns_resolution_enabled': 'bool', 'vcn_id': 'str', 'subnet_id': 'str', 'private_ip': 'str', @@ -125,6 +130,7 @@ def __init__(self, **kwargs): 'name': 'name', 'compartment_id': 'compartmentId', 'is_cluster': 'isCluster', + 'is_dns_resolution_enabled': 'isDnsResolutionEnabled', 'vcn_id': 'vcnId', 'subnet_id': 'subnetId', 'private_ip': 'privateIp', @@ -141,6 +147,7 @@ def __init__(self, **kwargs): self._name = None self._compartment_id = None self._is_cluster = None + self._is_dns_resolution_enabled = None self._vcn_id = None self._subnet_id = None self._private_ip = None @@ -256,6 +263,30 @@ def is_cluster(self, is_cluster): """ self._is_cluster = is_cluster + @property + def is_dns_resolution_enabled(self): + """ + Gets the is_dns_resolution_enabled of this DbManagementPrivateEndpoint. + Specifies whether the Database Management private endpoint has DNS proxy server enabled to resolve private host name. + + + :return: The is_dns_resolution_enabled of this DbManagementPrivateEndpoint. + :rtype: bool + """ + return self._is_dns_resolution_enabled + + @is_dns_resolution_enabled.setter + def is_dns_resolution_enabled(self, is_dns_resolution_enabled): + """ + Sets the is_dns_resolution_enabled of this DbManagementPrivateEndpoint. + Specifies whether the Database Management private endpoint has DNS proxy server enabled to resolve private host name. + + + :param is_dns_resolution_enabled: The is_dns_resolution_enabled of this DbManagementPrivateEndpoint. + :type: bool + """ + self._is_dns_resolution_enabled = is_dns_resolution_enabled + @property def vcn_id(self): """ diff --git a/src/oci/database_management/models/direct_connector_details.py b/src/oci/database_management/models/direct_connector_details.py new file mode 100644 index 0000000000..14e7dd8503 --- /dev/null +++ b/src/oci/database_management/models/direct_connector_details.py @@ -0,0 +1,51 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + +from .connector_details import ConnectorDetails +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 DirectConnectorDetails(ConnectorDetails): + """ + The connector details required to connect to an Autonomous Database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DirectConnectorDetails object with values from keyword arguments. The default value of the :py:attr:`~oci.database_management.models.DirectConnectorDetails.connector_type` attribute + of this class is ``DIRECT`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param connector_type: + The value to assign to the connector_type property of this DirectConnectorDetails. + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT" + :type connector_type: str + + """ + self.swagger_types = { + 'connector_type': 'str' + } + + self.attribute_map = { + 'connector_type': 'connectorType' + } + + self._connector_type = None + self._connector_type = 'DIRECT' + + 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_management/models/disable_autonomous_database_management_feature_details.py b/src/oci/database_management/models/disable_autonomous_database_management_feature_details.py new file mode 100644 index 0000000000..ca162acab5 --- /dev/null +++ b/src/oci/database_management/models/disable_autonomous_database_management_feature_details.py @@ -0,0 +1,92 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + + +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 DisableAutonomousDatabaseManagementFeatureDetails(object): + """ + The details required to disable a Database Management feature for an Autonomous Database. + """ + + #: A constant which can be used with the feature property of a DisableAutonomousDatabaseManagementFeatureDetails. + #: This constant has a value of "DIAGNOSTICS_AND_MANAGEMENT" + FEATURE_DIAGNOSTICS_AND_MANAGEMENT = "DIAGNOSTICS_AND_MANAGEMENT" + + #: A constant which can be used with the feature property of a DisableAutonomousDatabaseManagementFeatureDetails. + #: This constant has a value of "DB_LIFECYCLE_MANAGEMENT" + FEATURE_DB_LIFECYCLE_MANAGEMENT = "DB_LIFECYCLE_MANAGEMENT" + + #: A constant which can be used with the feature property of a DisableAutonomousDatabaseManagementFeatureDetails. + #: This constant has a value of "SQLWATCH" + FEATURE_SQLWATCH = "SQLWATCH" + + def __init__(self, **kwargs): + """ + Initializes a new DisableAutonomousDatabaseManagementFeatureDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature: + The value to assign to the feature property of this DisableAutonomousDatabaseManagementFeatureDetails. + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + :type feature: str + + """ + self.swagger_types = { + 'feature': 'str' + } + + self.attribute_map = { + 'feature': 'feature' + } + + self._feature = None + + @property + def feature(self): + """ + **[Required]** Gets the feature of this DisableAutonomousDatabaseManagementFeatureDetails. + The name of the Database Management feature. + + Allowed values for this property are: "DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH" + + + :return: The feature of this DisableAutonomousDatabaseManagementFeatureDetails. + :rtype: str + """ + return self._feature + + @feature.setter + def feature(self, feature): + """ + Sets the feature of this DisableAutonomousDatabaseManagementFeatureDetails. + The name of the Database Management feature. + + + :param feature: The feature of this DisableAutonomousDatabaseManagementFeatureDetails. + :type: str + """ + allowed_values = ["DIAGNOSTICS_AND_MANAGEMENT", "DB_LIFECYCLE_MANAGEMENT", "SQLWATCH"] + if not value_allowed_none_or_none_sentinel(feature, allowed_values): + raise ValueError( + f"Invalid value for `feature`, must be None or one of {allowed_values}" + ) + self._feature = feature + + 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_management/models/enable_autonomous_database_management_feature_details.py b/src/oci/database_management/models/enable_autonomous_database_management_feature_details.py new file mode 100644 index 0000000000..55dd184d21 --- /dev/null +++ b/src/oci/database_management/models/enable_autonomous_database_management_feature_details.py @@ -0,0 +1,68 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + + +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 EnableAutonomousDatabaseManagementFeatureDetails(object): + """ + The details required to enable a Database Management feature for an Autonomous Database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new EnableAutonomousDatabaseManagementFeatureDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature_details: + The value to assign to the feature_details property of this EnableAutonomousDatabaseManagementFeatureDetails. + :type feature_details: oci.database_management.models.AutonomousDatabaseFeatureDetails + + """ + self.swagger_types = { + 'feature_details': 'AutonomousDatabaseFeatureDetails' + } + + self.attribute_map = { + 'feature_details': 'featureDetails' + } + + self._feature_details = None + + @property + def feature_details(self): + """ + **[Required]** Gets the feature_details of this EnableAutonomousDatabaseManagementFeatureDetails. + + :return: The feature_details of this EnableAutonomousDatabaseManagementFeatureDetails. + :rtype: oci.database_management.models.AutonomousDatabaseFeatureDetails + """ + return self._feature_details + + @feature_details.setter + def feature_details(self, feature_details): + """ + Sets the feature_details of this EnableAutonomousDatabaseManagementFeatureDetails. + + :param feature_details: The feature_details of this EnableAutonomousDatabaseManagementFeatureDetails. + :type: oci.database_management.models.AutonomousDatabaseFeatureDetails + """ + self._feature_details = feature_details + + 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_management/models/external_connector_details.py b/src/oci/database_management/models/external_connector_details.py index a7a495c93c..f74fa74723 100644 --- a/src/oci/database_management/models/external_connector_details.py +++ b/src/oci/database_management/models/external_connector_details.py @@ -23,7 +23,7 @@ def __init__(self, **kwargs): :param connector_type: The value to assign to the connector_type property of this ExternalConnectorDetails. - Allowed values for this property are: "PE", "MACS", "EXTERNAL" + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT" :type connector_type: str :param database_connector_id: diff --git a/src/oci/database_management/models/macs_connector_details.py b/src/oci/database_management/models/macs_connector_details.py index 505002f553..4397643099 100644 --- a/src/oci/database_management/models/macs_connector_details.py +++ b/src/oci/database_management/models/macs_connector_details.py @@ -23,7 +23,7 @@ def __init__(self, **kwargs): :param connector_type: The value to assign to the connector_type property of this MacsConnectorDetails. - Allowed values for this property are: "PE", "MACS", "EXTERNAL" + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT" :type connector_type: str :param management_agent_id: diff --git a/src/oci/database_management/models/modify_autonomous_database_management_feature_details.py b/src/oci/database_management/models/modify_autonomous_database_management_feature_details.py new file mode 100644 index 0000000000..3dbf419d1d --- /dev/null +++ b/src/oci/database_management/models/modify_autonomous_database_management_feature_details.py @@ -0,0 +1,68 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20201101 + + +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 ModifyAutonomousDatabaseManagementFeatureDetails(object): + """ + The details required to modify a Database Management feature for an Autonomous Database. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ModifyAutonomousDatabaseManagementFeatureDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param feature_details: + The value to assign to the feature_details property of this ModifyAutonomousDatabaseManagementFeatureDetails. + :type feature_details: oci.database_management.models.AutonomousDatabaseFeatureDetails + + """ + self.swagger_types = { + 'feature_details': 'AutonomousDatabaseFeatureDetails' + } + + self.attribute_map = { + 'feature_details': 'featureDetails' + } + + self._feature_details = None + + @property + def feature_details(self): + """ + **[Required]** Gets the feature_details of this ModifyAutonomousDatabaseManagementFeatureDetails. + + :return: The feature_details of this ModifyAutonomousDatabaseManagementFeatureDetails. + :rtype: oci.database_management.models.AutonomousDatabaseFeatureDetails + """ + return self._feature_details + + @feature_details.setter + def feature_details(self, feature_details): + """ + Sets the feature_details of this ModifyAutonomousDatabaseManagementFeatureDetails. + + :param feature_details: The feature_details of this ModifyAutonomousDatabaseManagementFeatureDetails. + :type: oci.database_management.models.AutonomousDatabaseFeatureDetails + """ + self._feature_details = feature_details + + 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_management/models/optimizer_statistics_collection_operation.py b/src/oci/database_management/models/optimizer_statistics_collection_operation.py index a41f1e8a30..f37f71bbc4 100644 --- a/src/oci/database_management/models/optimizer_statistics_collection_operation.py +++ b/src/oci/database_management/models/optimizer_statistics_collection_operation.py @@ -31,6 +31,10 @@ class OptimizerStatisticsCollectionOperation(object): #: This constant has a value of "TIMED_OUT" STATUS_TIMED_OUT = "TIMED_OUT" + #: A constant which can be used with the status property of a OptimizerStatisticsCollectionOperation. + #: This constant has a value of "UNKNOWN" + STATUS_UNKNOWN = "UNKNOWN" + def __init__(self, **kwargs): """ Initializes a new OptimizerStatisticsCollectionOperation object with values from keyword arguments. @@ -62,7 +66,7 @@ def __init__(self, **kwargs): :param status: The value to assign to the status property of this OptimizerStatisticsCollectionOperation. - Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type status: str @@ -297,7 +301,7 @@ def status(self): **[Required]** Gets the status of this OptimizerStatisticsCollectionOperation. The status of the operation such as Completed, and Failed. - Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -316,7 +320,7 @@ def status(self, status): :param status: The status of this OptimizerStatisticsCollectionOperation. :type: str """ - allowed_values = ["IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT"] + allowed_values = ["IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN"] if not value_allowed_none_or_none_sentinel(status, allowed_values): status = 'UNKNOWN_ENUM_VALUE' self._status = status diff --git a/src/oci/database_management/models/optimizer_statistics_collection_operation_summary.py b/src/oci/database_management/models/optimizer_statistics_collection_operation_summary.py index 6d2dd030fa..6b9d49ee5e 100644 --- a/src/oci/database_management/models/optimizer_statistics_collection_operation_summary.py +++ b/src/oci/database_management/models/optimizer_statistics_collection_operation_summary.py @@ -31,6 +31,10 @@ class OptimizerStatisticsCollectionOperationSummary(object): #: This constant has a value of "TIMED_OUT" STATUS_TIMED_OUT = "TIMED_OUT" + #: A constant which can be used with the status property of a OptimizerStatisticsCollectionOperationSummary. + #: This constant has a value of "UNKNOWN" + STATUS_UNKNOWN = "UNKNOWN" + def __init__(self, **kwargs): """ Initializes a new OptimizerStatisticsCollectionOperationSummary object with values from keyword arguments. @@ -54,7 +58,7 @@ def __init__(self, **kwargs): :param status: The value to assign to the status property of this OptimizerStatisticsCollectionOperationSummary. - Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type status: str @@ -239,7 +243,7 @@ def status(self): **[Required]** Gets the status of this OptimizerStatisticsCollectionOperationSummary. The status of the operation such as Completed, and Failed. - Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -258,7 +262,7 @@ def status(self, status): :param status: The status of this OptimizerStatisticsCollectionOperationSummary. :type: str """ - allowed_values = ["IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT"] + allowed_values = ["IN_PROGRESS", "COMPLETED", "FAILED", "TIMED_OUT", "UNKNOWN"] if not value_allowed_none_or_none_sentinel(status, allowed_values): status = 'UNKNOWN_ENUM_VALUE' self._status = status diff --git a/src/oci/database_management/models/private_end_point_connector_details.py b/src/oci/database_management/models/private_end_point_connector_details.py index ecabb9ab45..92a48dd644 100644 --- a/src/oci/database_management/models/private_end_point_connector_details.py +++ b/src/oci/database_management/models/private_end_point_connector_details.py @@ -23,7 +23,7 @@ def __init__(self, **kwargs): :param connector_type: The value to assign to the connector_type property of this PrivateEndPointConnectorDetails. - Allowed values for this property are: "PE", "MACS", "EXTERNAL" + Allowed values for this property are: "PE", "MACS", "EXTERNAL", "DIRECT" :type connector_type: str :param private_end_point_id: diff --git a/src/oci/delegate_access_control/__init__.py b/src/oci/delegate_access_control/__init__.py new file mode 100644 index 0000000000..e6fc1c6aaa --- /dev/null +++ b/src/oci/delegate_access_control/__init__.py @@ -0,0 +1,16 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +from __future__ import absolute_import + + +from .delegate_access_control_client import DelegateAccessControlClient +from .delegate_access_control_client_composite_operations import DelegateAccessControlClientCompositeOperations +from .work_request_client import WorkRequestClient +from .work_request_client_composite_operations import WorkRequestClientCompositeOperations +from . import models + +__all__ = ["DelegateAccessControlClient", "DelegateAccessControlClientCompositeOperations", "WorkRequestClient", "WorkRequestClientCompositeOperations", "models"] diff --git a/src/oci/delegate_access_control/delegate_access_control_client.py b/src/oci/delegate_access_control/delegate_access_control_client.py new file mode 100644 index 0000000000..8d303b67e6 --- /dev/null +++ b/src/oci/delegate_access_control/delegate_access_control_client.py @@ -0,0 +1,3324 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +from __future__ import absolute_import + +from oci._vendor import requests # noqa: F401 +from oci._vendor import six + +from oci import retry, circuit_breaker # noqa: F401 +from oci.base_client import BaseClient +from oci.config import get_config_value_or_default, validate_config +from oci.signer import Signer +from oci.util import Sentinel, get_signer_from_authentication_type, AUTHENTICATION_TYPE_FIELD_NAME +from oci.exceptions import InvalidAlloyConfig +from oci.alloy import OCI_SDK_ENABLED_SERVICES_SET +from .models import delegate_access_control_type_mapping +missing = Sentinel("Missing") + + +class DelegateAccessControlClient(object): + """ + Oracle Delegate Access Control allows ExaCC and ExaCS customers to delegate management of their Exadata resources operators outside their tenancies. + With Delegate Access Control, Support Providers can deliver managed services using comprehensive and robust tooling built on the OCI platform. + Customers maintain control over who has access to the delegated resources in their tenancy and what actions can be taken. + Enterprises managing resources across multiple tenants can use Delegate Access Control to streamline management tasks. + Using logging service, customers can view a near real-time audit report of all actions performed by a Service Provider operator. + """ + + def __init__(self, config, **kwargs): + """ + Creates a new service client + + :param dict config: + Configuration keys and values as per `SDK and Tool Configuration `__. + The :py:meth:`~oci.config.from_file` method can be used to load configuration from a file. Alternatively, a ``dict`` can be passed. You can validate_config + the dict using :py:meth:`~oci.config.validate_config` + + :param str service_endpoint: (optional) + The endpoint of the service to call using this client. For example ``https://iaas.us-ashburn-1.oraclecloud.com``. If this keyword argument is + not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit + need to specify a service endpoint. + + :param timeout: (optional) + The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided + as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If + a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout. + :type timeout: float or tuple(float, float) + + :param signer: (optional) + The signer to use when signing requests made by the service client. The default is to use a :py:class:`~oci.signer.Signer` based on the values + provided in the config parameter. + + One use case for this parameter is for `Instance Principals authentication `__ + by passing an instance of :py:class:`~oci.auth.signers.InstancePrincipalsSecurityTokenSigner` as the value for this keyword argument + :type signer: :py:class:`~oci.signer.AbstractBaseSigner` + + :param obj retry_strategy: (optional) + A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. + Retry strategies can also be applied at the operation level by passing a ``retry_strategy`` keyword argument as part of calling the operation. + Any value provided at the operation level will override whatever is specified at the client level. + + This should be one of the strategies available in the :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 obj circuit_breaker_strategy: (optional) + A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level). + This client uses :py:data:`~oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY` as default if no circuit breaker strategy is provided. + The specifics of circuit breaker strategy are described `here `__. + + :param function circuit_breaker_callback: (optional) + Callback function to receive any exceptions triggerred by the circuit breaker. + + :param bool client_level_realm_specific_endpoint_template_enabled: (optional) + A boolean flag to indicate whether or not this client should be created with realm specific endpoint template enabled or disable. By default, this will be set as None. + + :param allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not + allow control characters to be in the response object. + """ + if not OCI_SDK_ENABLED_SERVICES_SET.is_service_enabled("delegate_access_control"): + raise InvalidAlloyConfig("The Alloy configuration has disabled this service, this behavior is controlled by OCI_SDK_ENABLED_SERVICES_SET variable. Please check if your local alloy-config file configured the service you're targeting or contact the cloud provider on the availability of this service") + + validate_config(config, signer=kwargs.get('signer')) + if 'signer' in kwargs: + signer = kwargs['signer'] + + elif AUTHENTICATION_TYPE_FIELD_NAME in config: + signer = get_signer_from_authentication_type(config) + + else: + signer = Signer( + tenancy=config["tenancy"], + user=config["user"], + fingerprint=config["fingerprint"], + private_key_file_location=config.get("key_file"), + pass_phrase=get_config_value_or_default(config, "pass_phrase"), + private_key_content=config.get("key_content") + ) + + base_client_init_kwargs = { + 'regional_client': True, + 'service_endpoint': kwargs.get('service_endpoint'), + 'base_path': '/20230801', + 'service_endpoint_template': 'https://delegate-access-control.{region}.oci.{secondLevelDomain}', + 'service_endpoint_template_per_realm': { }, # noqa: E201 E202 + 'skip_deserialization': kwargs.get('skip_deserialization', False), + 'circuit_breaker_strategy': kwargs.get('circuit_breaker_strategy', circuit_breaker.GLOBAL_CIRCUIT_BREAKER_STRATEGY), + 'client_level_realm_specific_endpoint_template_enabled': kwargs.get('client_level_realm_specific_endpoint_template_enabled') + } + if 'timeout' in kwargs: + base_client_init_kwargs['timeout'] = kwargs.get('timeout') + if base_client_init_kwargs.get('circuit_breaker_strategy') is None: + base_client_init_kwargs['circuit_breaker_strategy'] = circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY + if 'allow_control_chars' in kwargs: + base_client_init_kwargs['allow_control_chars'] = kwargs.get('allow_control_chars') + self.base_client = BaseClient("delegate_access_control", config, signer, delegate_access_control_type_mapping, **base_client_init_kwargs) + self.retry_strategy = kwargs.get('retry_strategy') + self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback') + + def approve_delegated_resource_access_request(self, delegated_resource_access_request_id, approve_delegated_resource_access_request_details, **kwargs): + """ + Approves a Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails approve_delegated_resource_access_request_details: (required) + Details regarding the approval of a Delegated Resource Access Request created by the support operator. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 approve_delegated_resource_access_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/actions/approve" + method = "POST" + operation_name = "approve_delegated_resource_access_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"approve_delegated_resource_access_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=approve_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=approve_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def change_delegation_control_compartment(self, delegation_control_id, change_delegation_control_compartment_details, **kwargs): + """ + Moves the Delegation Control resource into a different compartment. When provided, 'If-Match' is checked against 'ETag' values of the resource. + + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails change_delegation_control_compartment_details: (required) + Moves the Delegation Control resource into a different compartment. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_delegation_control_compartment API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationControlId'] + resource_path = "/delegationControls/{delegationControlId}/actions/changeCompartment" + method = "POST" + operation_name = "change_delegation_control_compartment" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"change_delegation_control_compartment got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationControlId": delegation_control_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_delegation_control_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_delegation_control_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def change_delegation_subscription_compartment(self, delegation_subscription_id, change_delegation_subscription_compartment_details, **kwargs): + """ + Moves the Delegation Subscription resource into a different compartment. When provided, 'If-Match' is checked against 'ETag' values of the resource. + + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails change_delegation_subscription_compartment_details: (required) + Moves the Delegation Subscription resource into a different compartment. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_delegation_subscription_compartment API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationSubscriptionId'] + resource_path = "/delegationSubscriptions/{delegationSubscriptionId}/actions/changeCompartment" + method = "POST" + operation_name = "change_delegation_subscription_compartment" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"change_delegation_subscription_compartment got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationSubscriptionId": delegation_subscription_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_delegation_subscription_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_delegation_subscription_compartment_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def create_delegation_control(self, create_delegation_control_details, **kwargs): + """ + Creates a Delegation Control. + + + :param oci.delegate_access_control.models.CreateDelegationControlDetails create_delegation_control_details: (required) + Details for the new Delegation Control. + + :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 + might be rejected. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationControl` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use create_delegation_control API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/delegationControls" + method = "POST" + operation_name = "create_delegation_control" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"create_delegation_control got unknown kwargs: {extra_kwargs!r}") + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_delegation_control_details, + response_type="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_delegation_control_details, + response_type="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def create_delegation_subscription(self, create_delegation_subscription_details, **kwargs): + """ + Creates Delegation Subscription in Delegation Control. + + + :param oci.delegate_access_control.models.CreateDelegationSubscriptionDetails create_delegation_subscription_details: (required) + Details for creating Delegation Subscription in Delegation Control. + + :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 + might be rejected. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationSubscription` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use create_delegation_subscription API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = [] + resource_path = "/delegationSubscriptions" + method = "POST" + operation_name = "create_delegation_subscription" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"create_delegation_subscription got unknown kwargs: {extra_kwargs!r}") + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + return retry_strategy.make_retrying_call( + self.base_client.call_api, + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_delegation_subscription_details, + response_type="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + header_params=header_params, + body=create_delegation_subscription_details, + response_type="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def delete_delegation_control(self, delegation_control_id, **kwargs): + """ + Deletes a Delegation Control. You cannot delete a Delegation Control if it is assigned to govern any target resource currently or in the future. + In that case, first, delete all of the current and future assignments before deleting the Delegation Control. A Delegation Control that was previously assigned to a target + resource is marked as DELETED following a successful deletion. However, it is not completely deleted from the system. This is to ensure auditing information for the accesses + done under the Delegation Control is preserved for future needs. The system purges the deleted Delegation Control only when all of the audit data associated with the + Delegation Control are also deleted. Therefore, you cannot reuse the name of the deleted Delegation Control until the system purges the Delegation Control. + + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param str description: (optional) + Reason why this Delegation Control is deleted. + + :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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_delegation_control API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationControlId'] + resource_path = "/delegationControls/{delegationControlId}" + method = "DELETE" + operation_name = "delete_delegation_control" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "description", + "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( + f"delete_delegation_control got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationControlId": delegation_control_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "description": kwargs.get("description", 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def delete_delegation_subscription(self, delegation_subscription_id, **kwargs): + """ + eletes an Delegation Subscription in Delegation Control. + + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_delegation_subscription API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationSubscriptionId'] + resource_path = "/delegationSubscriptions/{delegationSubscriptionId}" + method = "DELETE" + operation_name = "delete_delegation_subscription" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"delete_delegation_subscription got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationSubscriptionId": delegation_subscription_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_delegated_resource_access_request(self, delegated_resource_access_request_id, **kwargs): + """ + Gets details of a Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegatedResourceAccessRequest` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_delegated_resource_access_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}" + method = "GET" + operation_name = "get_delegated_resource_access_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_delegated_resource_access_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegatedResourceAccessRequest", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DelegatedResourceAccessRequest", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_delegated_resource_access_request_audit_log_report(self, delegated_resource_access_request_id, **kwargs): + """ + Gets the audit log report for the given Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param bool is_process_tree_enabled: (optional) + Set to true to enable process tree computation in audit report + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegatedResourceAccessRequestAuditLogReport` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_delegated_resource_access_request_audit_log_report API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/delegatedResourceAccessRequestAuditLogReport" + method = "GET" + operation_name = "get_delegated_resource_access_request_audit_log_report" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "is_process_tree_enabled", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"get_delegated_resource_access_request_audit_log_report got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + query_params = { + "isProcessTreeEnabled": kwargs.get("is_process_tree_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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegatedResourceAccessRequestAuditLogReport", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="DelegatedResourceAccessRequestAuditLogReport", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_delegation_control(self, delegation_control_id, **kwargs): + """ + Gets the Delegation Control associated with the specified Delegation Control ID. + + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationControl` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_delegation_control API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationControlId'] + resource_path = "/delegationControls/{delegationControlId}" + method = "GET" + operation_name = "get_delegation_control" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_delegation_control got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationControlId": delegation_control_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_delegation_subscription(self, delegation_subscription_id, **kwargs): + """ + Gets a DelegationSubscription by identifier + + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationSubscription` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_delegation_subscription API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationSubscriptionId'] + resource_path = "/delegationSubscriptions/{delegationSubscriptionId}" + method = "GET" + operation_name = "get_delegation_subscription" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_delegation_subscription got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationSubscriptionId": delegation_subscription_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_service_provider(self, service_provider_id, **kwargs): + """ + Gets a ServiceProvider by identifier + + + :param str service_provider_id: (required) + unique Service Provider identifier + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.ServiceProvider` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_service_provider API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['serviceProviderId'] + resource_path = "/serviceProviders/{serviceProviderId}" + method = "GET" + operation_name = "get_service_provider" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_service_provider got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "serviceProviderId": service_provider_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServiceProvider", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ServiceProvider", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_service_provider_action(self, service_provider_action_id, **kwargs): + """ + Gets the Service Provider Action associated with the specified Service Provider Action ID. + + + :param str service_provider_action_id: (required) + Unique Oracle supplied identifier associated with the Service Provider Action. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.ServiceProviderAction` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_service_provider_action API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['serviceProviderActionId'] + resource_path = "/serviceProviderActions/{serviceProviderActionId}" + method = "GET" + operation_name = "get_service_provider_action" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_service_provider_action got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "serviceProviderActionId": service_provider_action_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServiceProviderAction", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="ServiceProviderAction", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_delegated_resource_access_request_histories(self, delegated_resource_access_request_id, **kwargs): + """ + Returns a history of all status associated with the Delegated Resource Access RequestId. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timestamp is descending. If no value is specified, timestamp is default. + + Allowed values are: "timestamp" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegatedResourceAccessRequestHistoryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_delegated_resource_access_request_histories API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/history" + method = "GET" + operation_name = "list_delegated_resource_access_request_histories" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_delegated_resource_access_request_histories got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_order' in kwargs: + sort_order_allowed_values = ["ASC", "DESC"] + if kwargs['sort_order'] not in sort_order_allowed_values: + raise ValueError( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["timestamp"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegatedResourceAccessRequestHistoryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="DelegatedResourceAccessRequestHistoryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_delegated_resource_access_requests(self, compartment_id, **kwargs): + """ + Lists all Delegated Resource Access Requests in the compartment. Note that only one of lifecycleState or requestStatus query parameter can be used. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str delegation_control_id: (optional) + unique Delegation Control identifier + + :param str resource_id: (optional) + A filter to return only Delegated Resource Access Requests for the given resource identifier. + + :param str lifecycle_state: (optional) + A filter to return only Delegated Resource Access Requests whose lifecycleState matches the given Delegated Resource Access Request lifecycleState. + + Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", "NEEDS_ATTENTION" + + :param str request_status: (optional) + A filter to return only Delegated Resource Access Requests whose status matches the given Delegated Resource Access Request status. + + Allowed values are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED" + + :param datetime time_start: (optional) + Query start time in UTC in ISO 8601 format(inclusive). + Example 2019-10-30T00:00:00Z (yyyy-MM-ddThh:mm:ssZ). + timeIntervalStart and timeIntervalEnd parameters cannot be used together. + + :param datetime time_end: (optional) + Query end time in UTC in ISO 8601 format(inclusive). + Example 2019-10-30T00:00:00Z (yyyy-MM-ddThh:mm:ssZ). + timeIntervalStart and timeIntervalEnd parameters cannot be used together. + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified, default is timeCreated. + + Allowed values are: "timeCreated", "displayName" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegatedResourceAccessRequestSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_delegated_resource_access_requests API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/delegatedResourceAccessRequests" + method = "GET" + operation_name = "list_delegated_resource_access_requests" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "delegation_control_id", + "resource_id", + "lifecycle_state", + "request_status", + "time_start", + "time_end", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_delegated_resource_access_requests got unknown kwargs: {extra_kwargs!r}") + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", "NEEDS_ATTENTION"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + if 'request_status' in kwargs: + request_status_allowed_values = ["CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED"] + if kwargs['request_status'] not in request_status_allowed_values: + raise ValueError( + f"Invalid value for `request_status`, must be one of { request_status_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( + f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "delegationControlId": kwargs.get("delegation_control_id", missing), + "resourceId": kwargs.get("resource_id", missing), + "lifecycleState": kwargs.get("lifecycle_state", missing), + "requestStatus": kwargs.get("request_status", missing), + "timeStart": kwargs.get("time_start", missing), + "timeEnd": kwargs.get("time_end", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegatedResourceAccessRequestSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="DelegatedResourceAccessRequestSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_delegation_control_resources(self, delegation_control_id, **kwargs): + """ + Returns a list of resources associated with the Delegation Control. + + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationControlResourceCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_delegation_control_resources API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationControlId'] + resource_path = "/delegationControls/{delegationControlId}/resources" + method = "GET" + operation_name = "list_delegation_control_resources" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_delegation_control_resources got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationControlId": delegation_control_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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", + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegationControlResourceCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="DelegationControlResourceCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_delegation_controls(self, compartment_id, **kwargs): + """ + Lists the Delegation Controls in the compartment. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str lifecycle_state: (optional) + A filter to return only Delegation Control resources whose lifecycleState matches the given Delegation Control lifecycle state. + + Allowed values are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION" + + :param str display_name: (optional) + A filter to return Delegation Control resources that match the given display name. + + :param str resource_type: (optional) + A filter to return only resources that match the given resource type. + + Allowed values are: "VMCLUSTER", "CLOUDVMCLUSTER" + + :param str resource_id: (optional) + A filter to return Delegation Control resources that match the given resource ID. + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified, default is timeCreated. + + Allowed values are: "timeCreated", "displayName" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationControlSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_delegation_controls API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/delegationControls" + method = "GET" + operation_name = "list_delegation_controls" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "lifecycle_state", + "display_name", + "resource_type", + "resource_id", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_delegation_controls got unknown kwargs: {extra_kwargs!r}") + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + if 'resource_type' in kwargs: + resource_type_allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if kwargs['resource_type'] not in resource_type_allowed_values: + raise ValueError( + f"Invalid value for `resource_type`, must be one of { resource_type_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( + f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing), + "resourceType": kwargs.get("resource_type", missing), + "resourceId": kwargs.get("resource_id", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegationControlSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="DelegationControlSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_delegation_subscriptions(self, compartment_id, **kwargs): + """ + Lists the Delegation Subscriptions in Delegation Control. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str lifecycle_state: (optional) + A filter to return only Delegation Subscription resources whose lifecycleState matches the given Delegation Subscription lifecycle state. + + Allowed values are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED" + + :param str display_name: (optional) + A filter to return Delegation Subscription resources that match the given display name. + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified, timeCreated is default. + + Allowed values are: "timeCreated", "displayName" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationSubscriptionSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_delegation_subscriptions API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/delegationSubscriptions" + method = "GET" + operation_name = "list_delegation_subscriptions" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "lifecycle_state", + "display_name", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_delegation_subscriptions got unknown kwargs: {extra_kwargs!r}") + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_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( + f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "lifecycleState": kwargs.get("lifecycle_state", missing), + "displayName": kwargs.get("display_name", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="DelegationSubscriptionSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="DelegationSubscriptionSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_service_provider_actions(self, compartment_id, **kwargs): + """ + Lists all the ServiceProviderActions available in the system. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str name: (optional) + A filter to return only resources that match the entire name given. + + :param str resource_type: (optional) + A filter to return only resources that match the given resource type. + + Allowed values are: "VMCLUSTER", "CLOUDVMCLUSTER" + + :param list[str] service_provider_service_type: (optional) + A filter to return only resources that match the given Service Provider service type. + + Allowed values are: "TROUBLESHOOTING", "ASSISTED_PATCHING" + + :param str lifecycle_state: (optional) + A filter to return only resources whose lifecycleState matches the given Service Provider Action lifecycleState. + + Allowed values are: "ACTIVE", "INACTIVE" + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for name is ascending. If no value is specified, default is timeCreated. + + Allowed values are: "timeCreated", "name" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.ServiceProviderActionSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_service_provider_actions API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/serviceProviderActions" + method = "GET" + operation_name = "list_service_provider_actions" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "name", + "resource_type", + "service_provider_service_type", + "lifecycle_state", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_service_provider_actions got unknown kwargs: {extra_kwargs!r}") + + if 'resource_type' in kwargs: + resource_type_allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if kwargs['resource_type'] not in resource_type_allowed_values: + raise ValueError( + f"Invalid value for `resource_type`, must be one of { resource_type_allowed_values }" + ) + + if 'service_provider_service_type' in kwargs: + service_provider_service_type_allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + for service_provider_service_type_item in kwargs['service_provider_service_type']: + if service_provider_service_type_item not in service_provider_service_type_allowed_values: + raise ValueError( + f"Invalid value for `service_provider_service_type`, must be one of { service_provider_service_type_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["ACTIVE", "INACTIVE"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["timeCreated", "name"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "name": kwargs.get("name", missing), + "resourceType": kwargs.get("resource_type", missing), + "serviceProviderServiceType": self.base_client.generate_collection_format_param(kwargs.get("service_provider_service_type", missing), 'multi'), + "compartmentId": compartment_id, + "lifecycleState": kwargs.get("lifecycle_state", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServiceProviderActionSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="ServiceProviderActionSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_service_provider_interactions(self, delegated_resource_access_request_id, **kwargs): + """ + Lists the MoreInformation interaction between customer and support operators. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.ServiceProviderInteractionCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_service_provider_interactions API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/serviceProviderInteractions" + method = "GET" + operation_name = "list_service_provider_interactions" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"list_service_provider_interactions got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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", + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServiceProviderInteractionCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="ServiceProviderInteractionCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_service_providers(self, compartment_id, **kwargs): + """ + Lists the Service Providers. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str lifecycle_state: (optional) + A filter to return only Service Provider resources whose lifecycleState matches the given Service Provider lifecycle state. + + Allowed values are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED" + + :param str name: (optional) + A filter to return Service Provider resources that match the given name. + + :param str supported_resource_type: (optional) + A filter to return only Service Provider resources whose supported resource type matches the given resource type. + + Allowed values are: "VMCLUSTER", "CLOUDVMCLUSTER" + + :param str service_provider_type: (optional) + A filter to return only Service Provider resources whose provider type matches the given provider type. + + Allowed values are: "ORACLE_PROVIDED" + + :param int limit: (optional) + The maximum number of items to return. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for name is ascending. If no value is specified, timeCreated is default. + + Allowed values are: "timeCreated", "displayName" + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.ServiceProviderSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_service_providers API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/serviceProviders" + method = "GET" + operation_name = "list_service_providers" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "lifecycle_state", + "name", + "supported_resource_type", + "service_provider_type", + "limit", + "page", + "sort_order", + "sort_by", + "opc_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_service_providers got unknown kwargs: {extra_kwargs!r}") + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + if 'supported_resource_type' in kwargs: + supported_resource_type_allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if kwargs['supported_resource_type'] not in supported_resource_type_allowed_values: + raise ValueError( + f"Invalid value for `supported_resource_type`, must be one of { supported_resource_type_allowed_values }" + ) + + if 'service_provider_type' in kwargs: + service_provider_type_allowed_values = ["ORACLE_PROVIDED"] + if kwargs['service_provider_type'] not in service_provider_type_allowed_values: + raise ValueError( + f"Invalid value for `service_provider_type`, must be one of { service_provider_type_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( + f"Invalid value for `sort_order`, must be one of { sort_order_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( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "lifecycleState": kwargs.get("lifecycle_state", missing), + "name": kwargs.get("name", missing), + "supportedResourceType": kwargs.get("supported_resource_type", missing), + "serviceProviderType": kwargs.get("service_provider_type", missing), + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="ServiceProviderSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="ServiceProviderSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def reject_delegated_resource_access_request(self, delegated_resource_access_request_id, reject_delegated_resource_access_request_details, **kwargs): + """ + Rejects a Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails reject_delegated_resource_access_request_details: (required) + Details regarding the rejection of a Delegated Resource Access Request created by the support operator. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 reject_delegated_resource_access_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/actions/reject" + method = "POST" + operation_name = "reject_delegated_resource_access_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"reject_delegated_resource_access_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=reject_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=reject_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def revoke_delegated_resource_access_request(self, delegated_resource_access_request_id, revoke_delegated_resource_access_request_details, **kwargs): + """ + Revokes an already approved Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails revoke_delegated_resource_access_request_details: (required) + Details regarding the revocation of a Delegated Resource Access Request created by the support operator. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 revoke_delegated_resource_access_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/actions/revoke" + method = "POST" + operation_name = "revoke_delegated_resource_access_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"revoke_delegated_resource_access_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=revoke_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=revoke_delegated_resource_access_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def service_provider_interaction_request(self, delegated_resource_access_request_id, service_provider_interaction_request_details, **kwargs): + """ + Posts query for additional information for the given Delegated Resource Access Request. + + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.ServiceProviderInteractionRequestDetails service_provider_interaction_request_details: (required) + Details containing Query for additional information provided by Customer. + + :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 + might 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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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 service_provider_interaction_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegatedResourceAccessRequestId'] + resource_path = "/delegatedResourceAccessRequests/{delegatedResourceAccessRequestId}/actions/serviceProviderInteractionRequest" + method = "POST" + operation_name = "service_provider_interaction_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "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( + f"service_provider_interaction_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegatedResourceAccessRequestId": delegated_resource_access_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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-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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_retry_token_if_needed(header_params) + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=service_provider_interaction_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=service_provider_interaction_request_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def update_delegation_control(self, delegation_control_id, update_delegation_control_details, **kwargs): + """ + Updates the existing DelegationControl for a given Delegation Control ID. + + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param oci.delegate_access_control.models.UpdateDelegationControlDetails update_delegation_control_details: (required) + Details for the new DelegationControl. + + :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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationControl` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use update_delegation_control API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationControlId'] + resource_path = "/delegationControls/{delegationControlId}" + method = "PUT" + operation_name = "update_delegation_control" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"update_delegation_control got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationControlId": delegation_control_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_delegation_control_details, + response_type="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_delegation_control_details, + response_type="DelegationControl", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def update_delegation_subscription(self, delegation_subscription_id, update_delegation_subscription_details, **kwargs): + """ + Updates the existing DelegationSubscription for a given Delegation Subscription ID. + + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails update_delegation_subscription_details: (required) + Details for the DelegationSubscription to be updated. + + :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) + 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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.DelegationSubscription` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use update_delegation_subscription API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['delegationSubscriptionId'] + resource_path = "/delegationSubscriptions/{delegationSubscriptionId}" + method = "PUT" + operation_name = "update_delegation_subscription" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"update_delegation_subscription got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "delegationSubscriptionId": delegation_subscription_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_delegation_subscription_details, + response_type="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_delegation_subscription_details, + response_type="DelegationSubscription", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) diff --git a/src/oci/delegate_access_control/delegate_access_control_client_composite_operations.py b/src/oci/delegate_access_control/delegate_access_control_client_composite_operations.py new file mode 100644 index 0000000000..c511912829 --- /dev/null +++ b/src/oci/delegate_access_control/delegate_access_control_client_composite_operations.py @@ -0,0 +1,492 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +import oci # noqa: F401 +from oci.util import WAIT_RESOURCE_NOT_FOUND # noqa: F401 + + +class DelegateAccessControlClientCompositeOperations(object): + """ + This class provides a wrapper around :py:class:`~oci.delegate_access_control.DelegateAccessControlClient` and offers convenience methods + for operations that would otherwise need to be chained together. For example, instead of performing an action + on a resource (e.g. launching an instance, creating a load balancer) and then using a waiter to wait for the resource + to enter a given state, you can call a single method in this class to accomplish the same functionality + """ + + def __init__(self, client, **kwargs): + """ + Creates a new DelegateAccessControlClientCompositeOperations object + + :param DelegateAccessControlClient client: + The service client which will be wrapped by this object + """ + self.client = client + + def approve_delegated_resource_access_request_and_wait_for_state(self, delegated_resource_access_request_id, approve_delegated_resource_access_request_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.approve_delegated_resource_access_request` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.ApproveDelegatedResourceAccessRequestDetails approve_delegated_resource_access_request_details: (required) + Details regarding the approval of a Delegated Resource Access Request created by the support operator. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.approve_delegated_resource_access_request` + + :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.approve_delegated_resource_access_request(delegated_resource_access_request_id, approve_delegated_resource_access_request_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 change_delegation_control_compartment_and_wait_for_state(self, delegation_control_id, change_delegation_control_compartment_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.change_delegation_control_compartment` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param oci.delegate_access_control.models.ChangeDelegationControlCompartmentDetails change_delegation_control_compartment_details: (required) + Moves the Delegation Control resource into a different compartment. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.change_delegation_control_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_delegation_control_compartment(delegation_control_id, change_delegation_control_compartment_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 change_delegation_subscription_compartment_and_wait_for_state(self, delegation_subscription_id, change_delegation_subscription_compartment_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.change_delegation_subscription_compartment` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param oci.delegate_access_control.models.ChangeDelegationSubscriptionCompartmentDetails change_delegation_subscription_compartment_details: (required) + Moves the Delegation Subscription resource into a different compartment. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.change_delegation_subscription_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_delegation_subscription_compartment(delegation_subscription_id, change_delegation_subscription_compartment_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_control_and_wait_for_state(self, create_delegation_control_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.create_delegation_control` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param oci.delegate_access_control.models.CreateDelegationControlDetails create_delegation_control_details: (required) + Details for the new Delegation Control. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.create_delegation_control` + + :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_delegation_control(create_delegation_control_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_subscription_and_wait_for_state(self, create_delegation_subscription_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.create_delegation_subscription` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param oci.delegate_access_control.models.CreateDelegationSubscriptionDetails create_delegation_subscription_details: (required) + Details for creating Delegation Subscription in Delegation Control. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.create_delegation_subscription` + + :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_delegation_subscription(create_delegation_subscription_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_control_and_wait_for_state(self, delegation_control_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.delete_delegation_control` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.delete_delegation_control` + + :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 = None + try: + operation_result = self.client.delete_delegation_control(delegation_control_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_subscription_and_wait_for_state(self, delegation_subscription_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.delete_delegation_subscription` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.delete_delegation_subscription` + + :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 = None + try: + operation_result = self.client.delete_delegation_subscription(delegation_subscription_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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 reject_delegated_resource_access_request_and_wait_for_state(self, delegated_resource_access_request_id, reject_delegated_resource_access_request_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.reject_delegated_resource_access_request` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.RejectDelegatedResourceAccessRequestDetails reject_delegated_resource_access_request_details: (required) + Details regarding the rejection of a Delegated Resource Access Request created by the support operator. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.reject_delegated_resource_access_request` + + :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.reject_delegated_resource_access_request(delegated_resource_access_request_id, reject_delegated_resource_access_request_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 revoke_delegated_resource_access_request_and_wait_for_state(self, delegated_resource_access_request_id, revoke_delegated_resource_access_request_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.revoke_delegated_resource_access_request` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegated_resource_access_request_id: (required) + Unique Delegated Resource Access Request identifier + + :param oci.delegate_access_control.models.RevokeDelegatedResourceAccessRequestDetails revoke_delegated_resource_access_request_details: (required) + Details regarding the revocation of a Delegated Resource Access Request created by the support operator. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.revoke_delegated_resource_access_request` + + :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.revoke_delegated_resource_access_request(delegated_resource_access_request_id, revoke_delegated_resource_access_request_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_control_and_wait_for_state(self, delegation_control_id, update_delegation_control_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.update_delegation_control` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_control_id: (required) + unique Delegation Control identifier + + :param oci.delegate_access_control.models.UpdateDelegationControlDetails update_delegation_control_details: (required) + Details for the new DelegationControl. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.update_delegation_control` + + :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_delegation_control(delegation_control_id, update_delegation_control_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_delegation_subscription_and_wait_for_state(self, delegation_subscription_id, update_delegation_subscription_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.update_delegation_subscription` and waits for the :py:class:`~oci.delegate_access_control.models.WorkRequest` + to enter the given state(s). + + :param str delegation_subscription_id: (required) + unique Delegation Subscription identifier + + :param oci.delegate_access_control.models.UpdateDelegationSubscriptionDetails update_delegation_subscription_details: (required) + Details for the DelegationSubscription to be updated. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.delegate_access_control.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.delegate_access_control.DelegateAccessControlClient.update_delegation_subscription` + + :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_delegation_subscription(delegation_subscription_id, update_delegation_subscription_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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/delegate_access_control/models/__init__.py b/src/oci/delegate_access_control/models/__init__.py new file mode 100644 index 0000000000..98ff23ced3 --- /dev/null +++ b/src/oci/delegate_access_control/models/__init__.py @@ -0,0 +1,96 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +from __future__ import absolute_import + +from .approve_delegated_resource_access_request_details import ApproveDelegatedResourceAccessRequestDetails +from .change_delegation_control_compartment_details import ChangeDelegationControlCompartmentDetails +from .change_delegation_subscription_compartment_details import ChangeDelegationSubscriptionCompartmentDetails +from .create_delegation_control_details import CreateDelegationControlDetails +from .create_delegation_subscription_details import CreateDelegationSubscriptionDetails +from .delegated_resource_access_request import DelegatedResourceAccessRequest +from .delegated_resource_access_request_approval_details import DelegatedResourceAccessRequestApprovalDetails +from .delegated_resource_access_request_audit_log_report import DelegatedResourceAccessRequestAuditLogReport +from .delegated_resource_access_request_history_collection import DelegatedResourceAccessRequestHistoryCollection +from .delegated_resource_access_request_history_summary import DelegatedResourceAccessRequestHistorySummary +from .delegated_resource_access_request_summary import DelegatedResourceAccessRequestSummary +from .delegated_resource_access_request_summary_collection import DelegatedResourceAccessRequestSummaryCollection +from .delegation_control import DelegationControl +from .delegation_control_resource_collection import DelegationControlResourceCollection +from .delegation_control_resource_summary import DelegationControlResourceSummary +from .delegation_control_summary import DelegationControlSummary +from .delegation_control_summary_collection import DelegationControlSummaryCollection +from .delegation_subscription import DelegationSubscription +from .delegation_subscription_summary import DelegationSubscriptionSummary +from .delegation_subscription_summary_collection import DelegationSubscriptionSummaryCollection +from .reject_delegated_resource_access_request_details import RejectDelegatedResourceAccessRequestDetails +from .revoke_delegated_resource_access_request_details import RevokeDelegatedResourceAccessRequestDetails +from .service_provider import ServiceProvider +from .service_provider_action import ServiceProviderAction +from .service_provider_action_properties import ServiceProviderActionProperties +from .service_provider_action_summary import ServiceProviderActionSummary +from .service_provider_action_summary_collection import ServiceProviderActionSummaryCollection +from .service_provider_interaction_collection import ServiceProviderInteractionCollection +from .service_provider_interaction_request_details import ServiceProviderInteractionRequestDetails +from .service_provider_interaction_summary import ServiceProviderInteractionSummary +from .service_provider_summary import ServiceProviderSummary +from .service_provider_summary_collection import ServiceProviderSummaryCollection +from .update_delegation_control_details import UpdateDelegationControlDetails +from .update_delegation_subscription_details import UpdateDelegationSubscriptionDetails +from .work_request import WorkRequest +from .work_request_error import WorkRequestError +from .work_request_error_collection import WorkRequestErrorCollection +from .work_request_log_entry import WorkRequestLogEntry +from .work_request_log_entry_collection import WorkRequestLogEntryCollection +from .work_request_resource import WorkRequestResource +from .work_request_summary import WorkRequestSummary +from .work_request_summary_collection import WorkRequestSummaryCollection + +# Maps type names to classes for delegate_access_control services. +delegate_access_control_type_mapping = { + "ApproveDelegatedResourceAccessRequestDetails": ApproveDelegatedResourceAccessRequestDetails, + "ChangeDelegationControlCompartmentDetails": ChangeDelegationControlCompartmentDetails, + "ChangeDelegationSubscriptionCompartmentDetails": ChangeDelegationSubscriptionCompartmentDetails, + "CreateDelegationControlDetails": CreateDelegationControlDetails, + "CreateDelegationSubscriptionDetails": CreateDelegationSubscriptionDetails, + "DelegatedResourceAccessRequest": DelegatedResourceAccessRequest, + "DelegatedResourceAccessRequestApprovalDetails": DelegatedResourceAccessRequestApprovalDetails, + "DelegatedResourceAccessRequestAuditLogReport": DelegatedResourceAccessRequestAuditLogReport, + "DelegatedResourceAccessRequestHistoryCollection": DelegatedResourceAccessRequestHistoryCollection, + "DelegatedResourceAccessRequestHistorySummary": DelegatedResourceAccessRequestHistorySummary, + "DelegatedResourceAccessRequestSummary": DelegatedResourceAccessRequestSummary, + "DelegatedResourceAccessRequestSummaryCollection": DelegatedResourceAccessRequestSummaryCollection, + "DelegationControl": DelegationControl, + "DelegationControlResourceCollection": DelegationControlResourceCollection, + "DelegationControlResourceSummary": DelegationControlResourceSummary, + "DelegationControlSummary": DelegationControlSummary, + "DelegationControlSummaryCollection": DelegationControlSummaryCollection, + "DelegationSubscription": DelegationSubscription, + "DelegationSubscriptionSummary": DelegationSubscriptionSummary, + "DelegationSubscriptionSummaryCollection": DelegationSubscriptionSummaryCollection, + "RejectDelegatedResourceAccessRequestDetails": RejectDelegatedResourceAccessRequestDetails, + "RevokeDelegatedResourceAccessRequestDetails": RevokeDelegatedResourceAccessRequestDetails, + "ServiceProvider": ServiceProvider, + "ServiceProviderAction": ServiceProviderAction, + "ServiceProviderActionProperties": ServiceProviderActionProperties, + "ServiceProviderActionSummary": ServiceProviderActionSummary, + "ServiceProviderActionSummaryCollection": ServiceProviderActionSummaryCollection, + "ServiceProviderInteractionCollection": ServiceProviderInteractionCollection, + "ServiceProviderInteractionRequestDetails": ServiceProviderInteractionRequestDetails, + "ServiceProviderInteractionSummary": ServiceProviderInteractionSummary, + "ServiceProviderSummary": ServiceProviderSummary, + "ServiceProviderSummaryCollection": ServiceProviderSummaryCollection, + "UpdateDelegationControlDetails": UpdateDelegationControlDetails, + "UpdateDelegationSubscriptionDetails": UpdateDelegationSubscriptionDetails, + "WorkRequest": WorkRequest, + "WorkRequestError": WorkRequestError, + "WorkRequestErrorCollection": WorkRequestErrorCollection, + "WorkRequestLogEntry": WorkRequestLogEntry, + "WorkRequestLogEntryCollection": WorkRequestLogEntryCollection, + "WorkRequestResource": WorkRequestResource, + "WorkRequestSummary": WorkRequestSummary, + "WorkRequestSummaryCollection": WorkRequestSummaryCollection +} diff --git a/src/oci/delegate_access_control/models/approve_delegated_resource_access_request_details.py b/src/oci/delegate_access_control/models/approve_delegated_resource_access_request_details.py new file mode 100644 index 0000000000..ba73bb23b6 --- /dev/null +++ b/src/oci/delegate_access_control/models/approve_delegated_resource_access_request_details.py @@ -0,0 +1,138 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ApproveDelegatedResourceAccessRequestDetails(object): + """ + Details of the Delegated Resource Access Request approval. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ApproveDelegatedResourceAccessRequestDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param approver_comment: + The value to assign to the approver_comment property of this ApproveDelegatedResourceAccessRequestDetails. + :type approver_comment: str + + :param additional_message: + The value to assign to the additional_message property of this ApproveDelegatedResourceAccessRequestDetails. + :type additional_message: str + + :param time_approved_for_access: + The value to assign to the time_approved_for_access property of this ApproveDelegatedResourceAccessRequestDetails. + :type time_approved_for_access: datetime + + """ + self.swagger_types = { + 'approver_comment': 'str', + 'additional_message': 'str', + 'time_approved_for_access': 'datetime' + } + + self.attribute_map = { + 'approver_comment': 'approverComment', + 'additional_message': 'additionalMessage', + 'time_approved_for_access': 'timeApprovedForAccess' + } + + self._approver_comment = None + self._additional_message = None + self._time_approved_for_access = None + + @property + def approver_comment(self): + """ + Gets the approver_comment of this ApproveDelegatedResourceAccessRequestDetails. + Comment by the approver during approval. + + + :return: The approver_comment of this ApproveDelegatedResourceAccessRequestDetails. + :rtype: str + """ + return self._approver_comment + + @approver_comment.setter + def approver_comment(self, approver_comment): + """ + Sets the approver_comment of this ApproveDelegatedResourceAccessRequestDetails. + Comment by the approver during approval. + + + :param approver_comment: The approver_comment of this ApproveDelegatedResourceAccessRequestDetails. + :type: str + """ + self._approver_comment = approver_comment + + @property + def additional_message(self): + """ + Gets the additional_message of this ApproveDelegatedResourceAccessRequestDetails. + Message that needs to be displayed to the operator. + + + :return: The additional_message of this ApproveDelegatedResourceAccessRequestDetails. + :rtype: str + """ + return self._additional_message + + @additional_message.setter + def additional_message(self, additional_message): + """ + Sets the additional_message of this ApproveDelegatedResourceAccessRequestDetails. + Message that needs to be displayed to the operator. + + + :param additional_message: The additional_message of this ApproveDelegatedResourceAccessRequestDetails. + :type: str + """ + self._additional_message = additional_message + + @property + def time_approved_for_access(self): + """ + Gets the time_approved_for_access of this ApproveDelegatedResourceAccessRequestDetails. + Access start time that is actually approved by the customer in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_approved_for_access of this ApproveDelegatedResourceAccessRequestDetails. + :rtype: datetime + """ + return self._time_approved_for_access + + @time_approved_for_access.setter + def time_approved_for_access(self, time_approved_for_access): + """ + Sets the time_approved_for_access of this ApproveDelegatedResourceAccessRequestDetails. + Access start time that is actually approved by the customer in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_approved_for_access: The time_approved_for_access of this ApproveDelegatedResourceAccessRequestDetails. + :type: datetime + """ + self._time_approved_for_access = time_approved_for_access + + 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/delegate_access_control/models/change_delegation_control_compartment_details.py b/src/oci/delegate_access_control/models/change_delegation_control_compartment_details.py new file mode 100644 index 0000000000..4db0c20e05 --- /dev/null +++ b/src/oci/delegate_access_control/models/change_delegation_control_compartment_details.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ChangeDelegationControlCompartmentDetails(object): + """ + Details of the new compartment to contain the Delegation Control. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeDelegationControlCompartmentDetails 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 ChangeDelegationControlCompartmentDetails. + :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): + """ + Gets the compartment_id of this ChangeDelegationControlCompartmentDetails. + The OCID of the new compartment to contain the Delegation Control. + + + :return: The compartment_id of this ChangeDelegationControlCompartmentDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ChangeDelegationControlCompartmentDetails. + The OCID of the new compartment to contain the Delegation Control. + + + :param compartment_id: The compartment_id of this ChangeDelegationControlCompartmentDetails. + :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/delegate_access_control/models/change_delegation_subscription_compartment_details.py b/src/oci/delegate_access_control/models/change_delegation_subscription_compartment_details.py new file mode 100644 index 0000000000..6215efa69b --- /dev/null +++ b/src/oci/delegate_access_control/models/change_delegation_subscription_compartment_details.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ChangeDelegationSubscriptionCompartmentDetails(object): + """ + Details of the new compartment to contain the Delegation Subscription. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeDelegationSubscriptionCompartmentDetails 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 ChangeDelegationSubscriptionCompartmentDetails. + :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): + """ + Gets the compartment_id of this ChangeDelegationSubscriptionCompartmentDetails. + The OCID of the new compartment to contain the Delegation Subscription. + + + :return: The compartment_id of this ChangeDelegationSubscriptionCompartmentDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ChangeDelegationSubscriptionCompartmentDetails. + The OCID of the new compartment to contain the Delegation Subscription. + + + :param compartment_id: The compartment_id of this ChangeDelegationSubscriptionCompartmentDetails. + :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/delegate_access_control/models/create_delegation_control_details.py b/src/oci/delegate_access_control/models/create_delegation_control_details.py new file mode 100644 index 0000000000..306aa8c5c7 --- /dev/null +++ b/src/oci/delegate_access_control/models/create_delegation_control_details.py @@ -0,0 +1,548 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 CreateDelegationControlDetails(object): + """ + While creating the Delegation Control, specify how Service Provider Actions are approved and the users who have the privilege of approving the Service Provider Actions associated with the Delegation Control. + + You must specify which Service Provider Actions must be pre-approved. The rest of the Service Provider Actions associated with the Delegation Control will require an explicit approval from the users selected either through the approver groups or individually. + + You must name your Delegation Control appropriately so it reflects the resources that will be governed by the Delegation Control. Neither the Delegation Controls nor their assignments to resources are visible to the support operators. + """ + + #: A constant which can be used with the resource_type property of a CreateDelegationControlDetails. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a CreateDelegationControlDetails. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + def __init__(self, **kwargs): + """ + Initializes a new CreateDelegationControlDetails 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 CreateDelegationControlDetails. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this CreateDelegationControlDetails. + :type display_name: str + + :param description: + The value to assign to the description property of this CreateDelegationControlDetails. + :type description: str + + :param num_approvals_required: + The value to assign to the num_approvals_required property of this CreateDelegationControlDetails. + :type num_approvals_required: int + + :param pre_approved_service_provider_action_names: + The value to assign to the pre_approved_service_provider_action_names property of this CreateDelegationControlDetails. + :type pre_approved_service_provider_action_names: list[str] + + :param delegation_subscription_ids: + The value to assign to the delegation_subscription_ids property of this CreateDelegationControlDetails. + :type delegation_subscription_ids: list[str] + + :param is_auto_approve_during_maintenance: + The value to assign to the is_auto_approve_during_maintenance property of this CreateDelegationControlDetails. + :type is_auto_approve_during_maintenance: bool + + :param resource_ids: + The value to assign to the resource_ids property of this CreateDelegationControlDetails. + :type resource_ids: list[str] + + :param resource_type: + The value to assign to the resource_type property of this CreateDelegationControlDetails. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER" + :type resource_type: str + + :param notification_topic_id: + The value to assign to the notification_topic_id property of this CreateDelegationControlDetails. + :type notification_topic_id: str + + :param notification_message_format: + The value to assign to the notification_message_format property of this CreateDelegationControlDetails. + :type notification_message_format: str + + :param vault_id: + The value to assign to the vault_id property of this CreateDelegationControlDetails. + :type vault_id: str + + :param vault_key_id: + The value to assign to the vault_key_id property of this CreateDelegationControlDetails. + :type vault_key_id: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateDelegationControlDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateDelegationControlDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'num_approvals_required': 'int', + 'pre_approved_service_provider_action_names': 'list[str]', + 'delegation_subscription_ids': 'list[str]', + 'is_auto_approve_during_maintenance': 'bool', + 'resource_ids': 'list[str]', + 'resource_type': 'str', + 'notification_topic_id': 'str', + 'notification_message_format': 'str', + 'vault_id': 'str', + 'vault_key_id': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'num_approvals_required': 'numApprovalsRequired', + 'pre_approved_service_provider_action_names': 'preApprovedServiceProviderActionNames', + 'delegation_subscription_ids': 'delegationSubscriptionIds', + 'is_auto_approve_during_maintenance': 'isAutoApproveDuringMaintenance', + 'resource_ids': 'resourceIds', + 'resource_type': 'resourceType', + 'notification_topic_id': 'notificationTopicId', + 'notification_message_format': 'notificationMessageFormat', + 'vault_id': 'vaultId', + 'vault_key_id': 'vaultKeyId', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._display_name = None + self._description = None + self._num_approvals_required = None + self._pre_approved_service_provider_action_names = None + self._delegation_subscription_ids = None + self._is_auto_approve_during_maintenance = None + self._resource_ids = None + self._resource_type = None + self._notification_topic_id = None + self._notification_message_format = None + self._vault_id = None + self._vault_key_id = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateDelegationControlDetails. + The OCID of the compartment that contains this Delegation Control. + + + :return: The compartment_id of this CreateDelegationControlDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateDelegationControlDetails. + The OCID of the compartment that contains this Delegation Control. + + + :param compartment_id: The compartment_id of this CreateDelegationControlDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this CreateDelegationControlDetails. + Name of the Delegation Control. The name does not need to be unique. + + + :return: The display_name of this CreateDelegationControlDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this CreateDelegationControlDetails. + Name of the Delegation Control. The name does not need to be unique. + + + :param display_name: The display_name of this CreateDelegationControlDetails. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this CreateDelegationControlDetails. + Description of the Delegation Control. + + + :return: The description of this CreateDelegationControlDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this CreateDelegationControlDetails. + Description of the Delegation Control. + + + :param description: The description of this CreateDelegationControlDetails. + :type: str + """ + self._description = description + + @property + def num_approvals_required(self): + """ + Gets the num_approvals_required of this CreateDelegationControlDetails. + number of approvals required. + + + :return: The num_approvals_required of this CreateDelegationControlDetails. + :rtype: int + """ + return self._num_approvals_required + + @num_approvals_required.setter + def num_approvals_required(self, num_approvals_required): + """ + Sets the num_approvals_required of this CreateDelegationControlDetails. + number of approvals required. + + + :param num_approvals_required: The num_approvals_required of this CreateDelegationControlDetails. + :type: int + """ + self._num_approvals_required = num_approvals_required + + @property + def pre_approved_service_provider_action_names(self): + """ + Gets the pre_approved_service_provider_action_names of this CreateDelegationControlDetails. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :return: The pre_approved_service_provider_action_names of this CreateDelegationControlDetails. + :rtype: list[str] + """ + return self._pre_approved_service_provider_action_names + + @pre_approved_service_provider_action_names.setter + def pre_approved_service_provider_action_names(self, pre_approved_service_provider_action_names): + """ + Sets the pre_approved_service_provider_action_names of this CreateDelegationControlDetails. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :param pre_approved_service_provider_action_names: The pre_approved_service_provider_action_names of this CreateDelegationControlDetails. + :type: list[str] + """ + self._pre_approved_service_provider_action_names = pre_approved_service_provider_action_names + + @property + def delegation_subscription_ids(self): + """ + **[Required]** Gets the delegation_subscription_ids of this CreateDelegationControlDetails. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :return: The delegation_subscription_ids of this CreateDelegationControlDetails. + :rtype: list[str] + """ + return self._delegation_subscription_ids + + @delegation_subscription_ids.setter + def delegation_subscription_ids(self, delegation_subscription_ids): + """ + Sets the delegation_subscription_ids of this CreateDelegationControlDetails. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :param delegation_subscription_ids: The delegation_subscription_ids of this CreateDelegationControlDetails. + :type: list[str] + """ + self._delegation_subscription_ids = delegation_subscription_ids + + @property + def is_auto_approve_during_maintenance(self): + """ + Gets the is_auto_approve_during_maintenance of this CreateDelegationControlDetails. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :return: The is_auto_approve_during_maintenance of this CreateDelegationControlDetails. + :rtype: bool + """ + return self._is_auto_approve_during_maintenance + + @is_auto_approve_during_maintenance.setter + def is_auto_approve_during_maintenance(self, is_auto_approve_during_maintenance): + """ + Sets the is_auto_approve_during_maintenance of this CreateDelegationControlDetails. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :param is_auto_approve_during_maintenance: The is_auto_approve_during_maintenance of this CreateDelegationControlDetails. + :type: bool + """ + self._is_auto_approve_during_maintenance = is_auto_approve_during_maintenance + + @property + def resource_ids(self): + """ + **[Required]** Gets the resource_ids of this CreateDelegationControlDetails. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :return: The resource_ids of this CreateDelegationControlDetails. + :rtype: list[str] + """ + return self._resource_ids + + @resource_ids.setter + def resource_ids(self, resource_ids): + """ + Sets the resource_ids of this CreateDelegationControlDetails. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :param resource_ids: The resource_ids of this CreateDelegationControlDetails. + :type: list[str] + """ + self._resource_ids = resource_ids + + @property + def resource_type(self): + """ + **[Required]** Gets the resource_type of this CreateDelegationControlDetails. + Resource type for which the Delegation Control is applicable to. + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER" + + + :return: The resource_type of this CreateDelegationControlDetails. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this CreateDelegationControlDetails. + Resource type for which the Delegation Control is applicable to. + + + :param resource_type: The resource_type of this CreateDelegationControlDetails. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + raise ValueError( + f"Invalid value for `resource_type`, must be None or one of {allowed_values}" + ) + self._resource_type = resource_type + + @property + def notification_topic_id(self): + """ + **[Required]** Gets the notification_topic_id of this CreateDelegationControlDetails. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :return: The notification_topic_id of this CreateDelegationControlDetails. + :rtype: str + """ + return self._notification_topic_id + + @notification_topic_id.setter + def notification_topic_id(self, notification_topic_id): + """ + Sets the notification_topic_id of this CreateDelegationControlDetails. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :param notification_topic_id: The notification_topic_id of this CreateDelegationControlDetails. + :type: str + """ + self._notification_topic_id = notification_topic_id + + @property + def notification_message_format(self): + """ + **[Required]** Gets the notification_message_format of this CreateDelegationControlDetails. + The format of the OCI Notification messages for this Delegation Control. + + + :return: The notification_message_format of this CreateDelegationControlDetails. + :rtype: str + """ + return self._notification_message_format + + @notification_message_format.setter + def notification_message_format(self, notification_message_format): + """ + Sets the notification_message_format of this CreateDelegationControlDetails. + The format of the OCI Notification messages for this Delegation Control. + + + :param notification_message_format: The notification_message_format of this CreateDelegationControlDetails. + :type: str + """ + self._notification_message_format = notification_message_format + + @property + def vault_id(self): + """ + Gets the vault_id of this CreateDelegationControlDetails. + The OCID of the OCI Vault that will store the secrets containing the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. Delegate Access Control Service will generate the SSH keys and store them as secrets in the OCI Vault. + + + :return: The vault_id of this CreateDelegationControlDetails. + :rtype: str + """ + return self._vault_id + + @vault_id.setter + def vault_id(self, vault_id): + """ + Sets the vault_id of this CreateDelegationControlDetails. + The OCID of the OCI Vault that will store the secrets containing the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. Delegate Access Control Service will generate the SSH keys and store them as secrets in the OCI Vault. + + + :param vault_id: The vault_id of this CreateDelegationControlDetails. + :type: str + """ + self._vault_id = vault_id + + @property + def vault_key_id(self): + """ + Gets the vault_key_id of this CreateDelegationControlDetails. + The OCID of the Master Encryption Key in the OCI Vault specified by vaultId. This key will be used to encrypt the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. + + + :return: The vault_key_id of this CreateDelegationControlDetails. + :rtype: str + """ + return self._vault_key_id + + @vault_key_id.setter + def vault_key_id(self, vault_key_id): + """ + Sets the vault_key_id of this CreateDelegationControlDetails. + The OCID of the Master Encryption Key in the OCI Vault specified by vaultId. This key will be used to encrypt the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. + + + :param vault_key_id: The vault_key_id of this CreateDelegationControlDetails. + :type: str + """ + self._vault_key_id = vault_key_id + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateDelegationControlDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateDelegationControlDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateDelegationControlDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateDelegationControlDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateDelegationControlDetails. + 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 CreateDelegationControlDetails. + :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 CreateDelegationControlDetails. + 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 CreateDelegationControlDetails. + :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/delegate_access_control/models/create_delegation_subscription_details.py b/src/oci/delegate_access_control/models/create_delegation_subscription_details.py new file mode 100644 index 0000000000..68a25d2e7e --- /dev/null +++ b/src/oci/delegate_access_control/models/create_delegation_subscription_details.py @@ -0,0 +1,263 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 CreateDelegationSubscriptionDetails(object): + """ + Details for creating the Delegation Subscription. + """ + + #: A constant which can be used with the subscribed_service_type property of a CreateDelegationSubscriptionDetails. + #: This constant has a value of "TROUBLESHOOTING" + SUBSCRIBED_SERVICE_TYPE_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the subscribed_service_type property of a CreateDelegationSubscriptionDetails. + #: This constant has a value of "ASSISTED_PATCHING" + SUBSCRIBED_SERVICE_TYPE_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + def __init__(self, **kwargs): + """ + Initializes a new CreateDelegationSubscriptionDetails 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 CreateDelegationSubscriptionDetails. + :type compartment_id: str + + :param service_provider_id: + The value to assign to the service_provider_id property of this CreateDelegationSubscriptionDetails. + :type service_provider_id: str + + :param description: + The value to assign to the description property of this CreateDelegationSubscriptionDetails. + :type description: str + + :param subscribed_service_type: + The value to assign to the subscribed_service_type property of this CreateDelegationSubscriptionDetails. + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING" + :type subscribed_service_type: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreateDelegationSubscriptionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreateDelegationSubscriptionDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'compartment_id': 'str', + 'service_provider_id': 'str', + 'description': 'str', + 'subscribed_service_type': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'compartment_id': 'compartmentId', + 'service_provider_id': 'serviceProviderId', + 'description': 'description', + 'subscribed_service_type': 'subscribedServiceType', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._compartment_id = None + self._service_provider_id = None + self._description = None + self._subscribed_service_type = None + self._freeform_tags = None + self._defined_tags = None + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreateDelegationSubscriptionDetails. + The OCID of the compartment that contains the Delegation Control. + + + :return: The compartment_id of this CreateDelegationSubscriptionDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreateDelegationSubscriptionDetails. + The OCID of the compartment that contains the Delegation Control. + + + :param compartment_id: The compartment_id of this CreateDelegationSubscriptionDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def service_provider_id(self): + """ + **[Required]** Gets the service_provider_id of this CreateDelegationSubscriptionDetails. + Unique identifier of the Service Provider. + + + :return: The service_provider_id of this CreateDelegationSubscriptionDetails. + :rtype: str + """ + return self._service_provider_id + + @service_provider_id.setter + def service_provider_id(self, service_provider_id): + """ + Sets the service_provider_id of this CreateDelegationSubscriptionDetails. + Unique identifier of the Service Provider. + + + :param service_provider_id: The service_provider_id of this CreateDelegationSubscriptionDetails. + :type: str + """ + self._service_provider_id = service_provider_id + + @property + def description(self): + """ + Gets the description of this CreateDelegationSubscriptionDetails. + Description of the Delegation Subscription. + + + :return: The description of this CreateDelegationSubscriptionDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this CreateDelegationSubscriptionDetails. + Description of the Delegation Subscription. + + + :param description: The description of this CreateDelegationSubscriptionDetails. + :type: str + """ + self._description = description + + @property + def subscribed_service_type(self): + """ + **[Required]** Gets the subscribed_service_type of this CreateDelegationSubscriptionDetails. + Subscribed Service Provider Service Type. + + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING" + + + :return: The subscribed_service_type of this CreateDelegationSubscriptionDetails. + :rtype: str + """ + return self._subscribed_service_type + + @subscribed_service_type.setter + def subscribed_service_type(self, subscribed_service_type): + """ + Sets the subscribed_service_type of this CreateDelegationSubscriptionDetails. + Subscribed Service Provider Service Type. + + + :param subscribed_service_type: The subscribed_service_type of this CreateDelegationSubscriptionDetails. + :type: str + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if not value_allowed_none_or_none_sentinel(subscribed_service_type, allowed_values): + raise ValueError( + f"Invalid value for `subscribed_service_type`, must be None or one of {allowed_values}" + ) + self._subscribed_service_type = subscribed_service_type + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreateDelegationSubscriptionDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this CreateDelegationSubscriptionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreateDelegationSubscriptionDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this CreateDelegationSubscriptionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreateDelegationSubscriptionDetails. + 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 CreateDelegationSubscriptionDetails. + :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 CreateDelegationSubscriptionDetails. + 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 CreateDelegationSubscriptionDetails. + :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/delegate_access_control/models/delegated_resource_access_request.py b/src/oci/delegate_access_control/models/delegated_resource_access_request.py new file mode 100644 index 0000000000..4a07521258 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request.py @@ -0,0 +1,1373 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequest(object): + """ + A support operator raises Delegated Resource Access Request when they need access to any infrastructure resource governed by Delegation Control. + The Delegated Resource Access Request identifies the target resource and the set of Service Provider Actions. Delegated Resource Access Request handling depends upon the Delegation Control + that governs the target resource, and the set of Service Provider Actions listed for approval in the Delegated Resource Access Request. If all of the Service Provider Actions + listed in the Delegated Resource Access Request are in the pre-approved list in the Delegation Control that governs the target resource, then the Delegated Resource Access Request is + automatically approved. If not, then the Delegated Resource Access Request requires explicit approval from the approver group specified by the Delegation Control governing the target resource. + + You can approve or reject a Delegated Resource Access Request. You can also revoke the approval of an already approved Delegated Resource Access Request. While creating a Delegated Resource Access Request, + the support operator specifies the duration of access. You have the option to approve the entire duration or reduce or even increase the time duration. + A support operator can also request for an extension. The approval for such an extension is processed the same way the original Delegated Resource Access Request was processed. + """ + + #: A constant which can be used with the resource_type property of a DelegatedResourceAccessRequest. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequest. + #: This constant has a value of "OPERATOR" + REQUESTER_TYPE_OPERATOR = "OPERATOR" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CUSTOMER" + REQUESTER_TYPE_CUSTOMER = "CUSTOMER" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequest. + #: This constant has a value of "SYSTEM" + REQUESTER_TYPE_SYSTEM = "SYSTEM" + + #: A constant which can be used with the provided_service_types property of a DelegatedResourceAccessRequest. + #: This constant has a value of "TROUBLESHOOTING" + PROVIDED_SERVICE_TYPES_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the provided_service_types property of a DelegatedResourceAccessRequest. + #: This constant has a value of "ASSISTED_PATCHING" + PROVIDED_SERVICE_TYPES_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequest. + #: This constant has a value of "S1" + SEVERITY_S1 = "S1" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequest. + #: This constant has a value of "S2" + SEVERITY_S2 = "S2" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequest. + #: This constant has a value of "S3" + SEVERITY_S3 = "S3" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequest. + #: This constant has a value of "S4" + SEVERITY_S4 = "S4" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "ACCEPTED" + LIFECYCLE_STATE_ACCEPTED = "ACCEPTED" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "IN_PROGRESS" + LIFECYCLE_STATE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "WAITING" + LIFECYCLE_STATE_WAITING = "WAITING" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "SUCCEEDED" + LIFECYCLE_STATE_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CANCELING" + LIFECYCLE_STATE_CANCELING = "CANCELING" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CANCELED" + LIFECYCLE_STATE_CANCELED = "CANCELED" + + #: A constant which can be used with the lifecycle_state property of a DelegatedResourceAccessRequest. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CREATED" + REQUEST_STATUS_CREATED = "CREATED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "APPROVAL_WAITING" + REQUEST_STATUS_APPROVAL_WAITING = "APPROVAL_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "OPERATOR_ASSIGNMENT_WAITING" + REQUEST_STATUS_OPERATOR_ASSIGNMENT_WAITING = "OPERATOR_ASSIGNMENT_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "PREAPPROVED" + REQUEST_STATUS_PREAPPROVED = "PREAPPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "APPROVED" + REQUEST_STATUS_APPROVED = "APPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "APPROVED_FOR_FUTURE" + REQUEST_STATUS_APPROVED_FOR_FUTURE = "APPROVED_FOR_FUTURE" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "REJECTED" + REQUEST_STATUS_REJECTED = "REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "DEPLOYED" + REQUEST_STATUS_DEPLOYED = "DEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "DEPLOY_FAILED" + REQUEST_STATUS_DEPLOY_FAILED = "DEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "UNDEPLOYED" + REQUEST_STATUS_UNDEPLOYED = "UNDEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "UNDEPLOY_FAILED" + REQUEST_STATUS_UNDEPLOY_FAILED = "UNDEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "CLOSE_FAILED" + REQUEST_STATUS_CLOSE_FAILED = "CLOSE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "REVOKE_FAILED" + REQUEST_STATUS_REVOKE_FAILED = "REVOKE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXPIRY_FAILED" + REQUEST_STATUS_EXPIRY_FAILED = "EXPIRY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "REVOKING" + REQUEST_STATUS_REVOKING = "REVOKING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "REVOKED" + REQUEST_STATUS_REVOKED = "REVOKED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXTENDING" + REQUEST_STATUS_EXTENDING = "EXTENDING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXTENDED" + REQUEST_STATUS_EXTENDED = "EXTENDED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXTENSION_REJECTED" + REQUEST_STATUS_EXTENSION_REJECTED = "EXTENSION_REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXTENSION_FAILED" + REQUEST_STATUS_EXTENSION_FAILED = "EXTENSION_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "COMPLETING" + REQUEST_STATUS_COMPLETING = "COMPLETING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "COMPLETED" + REQUEST_STATUS_COMPLETED = "COMPLETED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequest. + #: This constant has a value of "EXPIRED" + REQUEST_STATUS_EXPIRED = "EXPIRED" + + #: A constant which can be used with the audit_types property of a DelegatedResourceAccessRequest. + #: This constant has a value of "COMMAND_AUDIT" + AUDIT_TYPES_COMMAND_AUDIT = "COMMAND_AUDIT" + + #: A constant which can be used with the audit_types property of a DelegatedResourceAccessRequest. + #: This constant has a value of "COMMAND_KEYSTROKE_AUDIT" + AUDIT_TYPES_COMMAND_KEYSTROKE_AUDIT = "COMMAND_KEYSTROKE_AUDIT" + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequest 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 DelegatedResourceAccessRequest. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegatedResourceAccessRequest. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this DelegatedResourceAccessRequest. + :type display_name: str + + :param ticket_numbers: + The value to assign to the ticket_numbers property of this DelegatedResourceAccessRequest. + :type ticket_numbers: list[str] + + :param reason_for_request: + The value to assign to the reason_for_request property of this DelegatedResourceAccessRequest. + :type reason_for_request: str + + :param description: + The value to assign to the description property of this DelegatedResourceAccessRequest. + :type description: str + + :param time_access_requested: + The value to assign to the time_access_requested property of this DelegatedResourceAccessRequest. + :type time_access_requested: datetime + + :param resource_id: + The value to assign to the resource_id property of this DelegatedResourceAccessRequest. + :type resource_id: str + + :param resource_name: + The value to assign to the resource_name property of this DelegatedResourceAccessRequest. + :type resource_name: str + + :param resource_type: + The value to assign to the resource_type property of this DelegatedResourceAccessRequest. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param requester_type: + The value to assign to the requester_type property of this DelegatedResourceAccessRequest. + Allowed values for this property are: "OPERATOR", "CUSTOMER", "SYSTEM", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type requester_type: str + + :param requested_action_names: + The value to assign to the requested_action_names property of this DelegatedResourceAccessRequest. + :type requested_action_names: list[str] + + :param database_name_list: + The value to assign to the database_name_list property of this DelegatedResourceAccessRequest. + :type database_name_list: list[str] + + :param provided_service_types: + The value to assign to the provided_service_types property of this DelegatedResourceAccessRequest. + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type provided_service_types: list[str] + + :param delegation_subscription_ids: + The value to assign to the delegation_subscription_ids property of this DelegatedResourceAccessRequest. + :type delegation_subscription_ids: list[str] + + :param severity: + The value to assign to the severity property of this DelegatedResourceAccessRequest. + Allowed values for this property are: "S1", "S2", "S3", "S4", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type severity: str + + :param duration_in_hours: + The value to assign to the duration_in_hours property of this DelegatedResourceAccessRequest. + :type duration_in_hours: int + + :param extend_duration_in_hours: + The value to assign to the extend_duration_in_hours property of this DelegatedResourceAccessRequest. + :type extend_duration_in_hours: int + + :param is_auto_approved: + The value to assign to the is_auto_approved property of this DelegatedResourceAccessRequest. + :type is_auto_approved: bool + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegatedResourceAccessRequest. + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", "NEEDS_ATTENTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegatedResourceAccessRequest. + :type lifecycle_state_details: str + + :param request_status: + The value to assign to the request_status property of this DelegatedResourceAccessRequest. + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type request_status: str + + :param time_created: + The value to assign to the time_created property of this DelegatedResourceAccessRequest. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegatedResourceAccessRequest. + :type time_updated: datetime + + :param num_initial_approvals: + The value to assign to the num_initial_approvals property of this DelegatedResourceAccessRequest. + :type num_initial_approvals: int + + :param num_extension_approvals: + The value to assign to the num_extension_approvals property of this DelegatedResourceAccessRequest. + :type num_extension_approvals: int + + :param approval_info: + The value to assign to the approval_info property of this DelegatedResourceAccessRequest. + :type approval_info: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails] + + :param closure_comment: + The value to assign to the closure_comment property of this DelegatedResourceAccessRequest. + :type closure_comment: str + + :param delegation_control_id: + The value to assign to the delegation_control_id property of this DelegatedResourceAccessRequest. + :type delegation_control_id: str + + :param audit_types: + The value to assign to the audit_types property of this DelegatedResourceAccessRequest. + Allowed values for items in this list are: "COMMAND_AUDIT", "COMMAND_KEYSTROKE_AUDIT", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type audit_types: list[str] + + :param is_pending_more_info: + The value to assign to the is_pending_more_info property of this DelegatedResourceAccessRequest. + :type is_pending_more_info: bool + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegatedResourceAccessRequest. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegatedResourceAccessRequest. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegatedResourceAccessRequest. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'ticket_numbers': 'list[str]', + 'reason_for_request': 'str', + 'description': 'str', + 'time_access_requested': 'datetime', + 'resource_id': 'str', + 'resource_name': 'str', + 'resource_type': 'str', + 'requester_type': 'str', + 'requested_action_names': 'list[str]', + 'database_name_list': 'list[str]', + 'provided_service_types': 'list[str]', + 'delegation_subscription_ids': 'list[str]', + 'severity': 'str', + 'duration_in_hours': 'int', + 'extend_duration_in_hours': 'int', + 'is_auto_approved': 'bool', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'request_status': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'num_initial_approvals': 'int', + 'num_extension_approvals': 'int', + 'approval_info': 'list[DelegatedResourceAccessRequestApprovalDetails]', + 'closure_comment': 'str', + 'delegation_control_id': 'str', + 'audit_types': 'list[str]', + 'is_pending_more_info': 'bool', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'ticket_numbers': 'ticketNumbers', + 'reason_for_request': 'reasonForRequest', + 'description': 'description', + 'time_access_requested': 'timeAccessRequested', + 'resource_id': 'resourceId', + 'resource_name': 'resourceName', + 'resource_type': 'resourceType', + 'requester_type': 'requesterType', + 'requested_action_names': 'requestedActionNames', + 'database_name_list': 'databaseNameList', + 'provided_service_types': 'providedServiceTypes', + 'delegation_subscription_ids': 'delegationSubscriptionIds', + 'severity': 'severity', + 'duration_in_hours': 'durationInHours', + 'extend_duration_in_hours': 'extendDurationInHours', + 'is_auto_approved': 'isAutoApproved', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'request_status': 'requestStatus', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'num_initial_approvals': 'numInitialApprovals', + 'num_extension_approvals': 'numExtensionApprovals', + 'approval_info': 'approvalInfo', + 'closure_comment': 'closureComment', + 'delegation_control_id': 'delegationControlId', + 'audit_types': 'auditTypes', + 'is_pending_more_info': 'isPendingMoreInfo', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._ticket_numbers = None + self._reason_for_request = None + self._description = None + self._time_access_requested = None + self._resource_id = None + self._resource_name = None + self._resource_type = None + self._requester_type = None + self._requested_action_names = None + self._database_name_list = None + self._provided_service_types = None + self._delegation_subscription_ids = None + self._severity = None + self._duration_in_hours = None + self._extend_duration_in_hours = None + self._is_auto_approved = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._request_status = None + self._time_created = None + self._time_updated = None + self._num_initial_approvals = None + self._num_extension_approvals = None + self._approval_info = None + self._closure_comment = None + self._delegation_control_id = None + self._audit_types = None + self._is_pending_more_info = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegatedResourceAccessRequest. + The OCID of the Delegated Resource Access Request. + + + :return: The id of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegatedResourceAccessRequest. + The OCID of the Delegated Resource Access Request. + + + :param id: The id of this DelegatedResourceAccessRequest. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this DelegatedResourceAccessRequest. + The OCID of the compartment that contains the Delegated Resource Access Request. + + + :return: The compartment_id of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegatedResourceAccessRequest. + The OCID of the compartment that contains the Delegated Resource Access Request. + + + :param compartment_id: The compartment_id of this DelegatedResourceAccessRequest. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this DelegatedResourceAccessRequest. + Display name. This is generated by the system automatically. + + + :return: The display_name of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegatedResourceAccessRequest. + Display name. This is generated by the system automatically. + + + :param display_name: The display_name of this DelegatedResourceAccessRequest. + :type: str + """ + self._display_name = display_name + + @property + def ticket_numbers(self): + """ + Gets the ticket_numbers of this DelegatedResourceAccessRequest. + A list of ticket numbers related to this Delegated Resource Access Request, e.g. Service Request (SR) number and JIRA ticket number. + + + :return: The ticket_numbers of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._ticket_numbers + + @ticket_numbers.setter + def ticket_numbers(self, ticket_numbers): + """ + Sets the ticket_numbers of this DelegatedResourceAccessRequest. + A list of ticket numbers related to this Delegated Resource Access Request, e.g. Service Request (SR) number and JIRA ticket number. + + + :param ticket_numbers: The ticket_numbers of this DelegatedResourceAccessRequest. + :type: list[str] + """ + self._ticket_numbers = ticket_numbers + + @property + def reason_for_request(self): + """ + **[Required]** Gets the reason_for_request of this DelegatedResourceAccessRequest. + A short description explaining why this Delegated Resource Access Request is needed by the support operator. + + + :return: The reason_for_request of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._reason_for_request + + @reason_for_request.setter + def reason_for_request(self, reason_for_request): + """ + Sets the reason_for_request of this DelegatedResourceAccessRequest. + A short description explaining why this Delegated Resource Access Request is needed by the support operator. + + + :param reason_for_request: The reason_for_request of this DelegatedResourceAccessRequest. + :type: str + """ + self._reason_for_request = reason_for_request + + @property + def description(self): + """ + **[Required]** Gets the description of this DelegatedResourceAccessRequest. + Detailed description of this Delegated Resource Access Request. + + + :return: The description of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this DelegatedResourceAccessRequest. + Detailed description of this Delegated Resource Access Request. + + + :param description: The description of this DelegatedResourceAccessRequest. + :type: str + """ + self._description = description + + @property + def time_access_requested(self): + """ + Gets the time_access_requested of this DelegatedResourceAccessRequest. + Requested access start time in UTC. + + + :return: The time_access_requested of this DelegatedResourceAccessRequest. + :rtype: datetime + """ + return self._time_access_requested + + @time_access_requested.setter + def time_access_requested(self, time_access_requested): + """ + Sets the time_access_requested of this DelegatedResourceAccessRequest. + Requested access start time in UTC. + + + :param time_access_requested: The time_access_requested of this DelegatedResourceAccessRequest. + :type: datetime + """ + self._time_access_requested = time_access_requested + + @property + def resource_id(self): + """ + **[Required]** Gets the resource_id of this DelegatedResourceAccessRequest. + The OCID of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :return: The resource_id of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._resource_id + + @resource_id.setter + def resource_id(self, resource_id): + """ + Sets the resource_id of this DelegatedResourceAccessRequest. + The OCID of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :param resource_id: The resource_id of this DelegatedResourceAccessRequest. + :type: str + """ + self._resource_id = resource_id + + @property + def resource_name(self): + """ + Gets the resource_name of this DelegatedResourceAccessRequest. + The name of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :return: The resource_name of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._resource_name + + @resource_name.setter + def resource_name(self, resource_name): + """ + Sets the resource_name of this DelegatedResourceAccessRequest. + The name of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :param resource_name: The resource_name of this DelegatedResourceAccessRequest. + :type: str + """ + self._resource_name = resource_name + + @property + def resource_type(self): + """ + Gets the resource_type of this DelegatedResourceAccessRequest. + Resource type for which the associated Delegation Control is applicable to. + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this DelegatedResourceAccessRequest. + Resource type for which the associated Delegation Control is applicable to. + + + :param resource_type: The resource_type of this DelegatedResourceAccessRequest. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def requester_type(self): + """ + Gets the requester_type of this DelegatedResourceAccessRequest. + Requester type + + Allowed values for this property are: "OPERATOR", "CUSTOMER", "SYSTEM", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The requester_type of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._requester_type + + @requester_type.setter + def requester_type(self, requester_type): + """ + Sets the requester_type of this DelegatedResourceAccessRequest. + Requester type + + + :param requester_type: The requester_type of this DelegatedResourceAccessRequest. + :type: str + """ + allowed_values = ["OPERATOR", "CUSTOMER", "SYSTEM"] + if not value_allowed_none_or_none_sentinel(requester_type, allowed_values): + requester_type = 'UNKNOWN_ENUM_VALUE' + self._requester_type = requester_type + + @property + def requested_action_names(self): + """ + Gets the requested_action_names of this DelegatedResourceAccessRequest. + List of Service Provider Action names for which approval is sought by the support operator user. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. + + + :return: The requested_action_names of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._requested_action_names + + @requested_action_names.setter + def requested_action_names(self, requested_action_names): + """ + Sets the requested_action_names of this DelegatedResourceAccessRequest. + List of Service Provider Action names for which approval is sought by the support operator user. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. + + + :param requested_action_names: The requested_action_names of this DelegatedResourceAccessRequest. + :type: list[str] + """ + self._requested_action_names = requested_action_names + + @property + def database_name_list(self): + """ + Gets the database_name_list of this DelegatedResourceAccessRequest. + List of Database unique names for which access is requested. This parameter is required for DLGT_MGMT_SYS_MAINT_ACCESS cage when database access in needed. + + + :return: The database_name_list of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._database_name_list + + @database_name_list.setter + def database_name_list(self, database_name_list): + """ + Sets the database_name_list of this DelegatedResourceAccessRequest. + List of Database unique names for which access is requested. This parameter is required for DLGT_MGMT_SYS_MAINT_ACCESS cage when database access in needed. + + + :param database_name_list: The database_name_list of this DelegatedResourceAccessRequest. + :type: list[str] + """ + self._database_name_list = database_name_list + + @property + def provided_service_types(self): + """ + Gets the provided_service_types of this DelegatedResourceAccessRequest. + List of Service Provider Service Types being provided by the support operator user. + + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The provided_service_types of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._provided_service_types + + @provided_service_types.setter + def provided_service_types(self, provided_service_types): + """ + Sets the provided_service_types of this DelegatedResourceAccessRequest. + List of Service Provider Service Types being provided by the support operator user. + + + :param provided_service_types: The provided_service_types of this DelegatedResourceAccessRequest. + :type: list[str] + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if provided_service_types: + provided_service_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in provided_service_types] + self._provided_service_types = provided_service_types + + @property + def delegation_subscription_ids(self): + """ + Gets the delegation_subscription_ids of this DelegatedResourceAccessRequest. + List of Delegation Subscription OCID that are associated with this Delegated Resource Access Request based on the service types being requested. + + + :return: The delegation_subscription_ids of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._delegation_subscription_ids + + @delegation_subscription_ids.setter + def delegation_subscription_ids(self, delegation_subscription_ids): + """ + Sets the delegation_subscription_ids of this DelegatedResourceAccessRequest. + List of Delegation Subscription OCID that are associated with this Delegated Resource Access Request based on the service types being requested. + + + :param delegation_subscription_ids: The delegation_subscription_ids of this DelegatedResourceAccessRequest. + :type: list[str] + """ + self._delegation_subscription_ids = delegation_subscription_ids + + @property + def severity(self): + """ + Gets the severity of this DelegatedResourceAccessRequest. + Priority assigned to the Delegated Resource Access Request by the support operator + + Allowed values for this property are: "S1", "S2", "S3", "S4", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The severity of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._severity + + @severity.setter + def severity(self, severity): + """ + Sets the severity of this DelegatedResourceAccessRequest. + Priority assigned to the Delegated Resource Access Request by the support operator + + + :param severity: The severity of this DelegatedResourceAccessRequest. + :type: str + """ + allowed_values = ["S1", "S2", "S3", "S4"] + if not value_allowed_none_or_none_sentinel(severity, allowed_values): + severity = 'UNKNOWN_ENUM_VALUE' + self._severity = severity + + @property + def duration_in_hours(self): + """ + Gets the duration_in_hours of this DelegatedResourceAccessRequest. + Duration in hours for which access is sought on the target resource. + + + :return: The duration_in_hours of this DelegatedResourceAccessRequest. + :rtype: int + """ + return self._duration_in_hours + + @duration_in_hours.setter + def duration_in_hours(self, duration_in_hours): + """ + Sets the duration_in_hours of this DelegatedResourceAccessRequest. + Duration in hours for which access is sought on the target resource. + + + :param duration_in_hours: The duration_in_hours of this DelegatedResourceAccessRequest. + :type: int + """ + self._duration_in_hours = duration_in_hours + + @property + def extend_duration_in_hours(self): + """ + Gets the extend_duration_in_hours of this DelegatedResourceAccessRequest. + Duration in hours for which extension access is sought on the target resource. + + + :return: The extend_duration_in_hours of this DelegatedResourceAccessRequest. + :rtype: int + """ + return self._extend_duration_in_hours + + @extend_duration_in_hours.setter + def extend_duration_in_hours(self, extend_duration_in_hours): + """ + Sets the extend_duration_in_hours of this DelegatedResourceAccessRequest. + Duration in hours for which extension access is sought on the target resource. + + + :param extend_duration_in_hours: The extend_duration_in_hours of this DelegatedResourceAccessRequest. + :type: int + """ + self._extend_duration_in_hours = extend_duration_in_hours + + @property + def is_auto_approved(self): + """ + Gets the is_auto_approved of this DelegatedResourceAccessRequest. + Set to true if the request is approved automatically based on preApprovedServiceProviderActionNames or isAutoApproveDuringMaintenance in the associated Delegation Control. + + + :return: The is_auto_approved of this DelegatedResourceAccessRequest. + :rtype: bool + """ + return self._is_auto_approved + + @is_auto_approved.setter + def is_auto_approved(self, is_auto_approved): + """ + Sets the is_auto_approved of this DelegatedResourceAccessRequest. + Set to true if the request is approved automatically based on preApprovedServiceProviderActionNames or isAutoApproveDuringMaintenance in the associated Delegation Control. + + + :param is_auto_approved: The is_auto_approved of this DelegatedResourceAccessRequest. + :type: bool + """ + self._is_auto_approved = is_auto_approved + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegatedResourceAccessRequest. + The current lifecycle state of the Delegated Resource Access Request. + + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", "NEEDS_ATTENTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegatedResourceAccessRequest. + The current lifecycle state of the Delegated Resource Access Request. + + + :param lifecycle_state: The lifecycle_state of this DelegatedResourceAccessRequest. + :type: str + """ + allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", "NEEDS_ATTENTION"] + 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_state_details(self): + """ + Gets the lifecycle_state_details of this DelegatedResourceAccessRequest. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegatedResourceAccessRequest. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegatedResourceAccessRequest. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def request_status(self): + """ + Gets the request_status of this DelegatedResourceAccessRequest. + The current status of the Delegated Resource Access Request. + + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The request_status of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._request_status + + @request_status.setter + def request_status(self, request_status): + """ + Sets the request_status of this DelegatedResourceAccessRequest. + The current status of the Delegated Resource Access Request. + + + :param request_status: The request_status of this DelegatedResourceAccessRequest. + :type: str + """ + allowed_values = ["CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED"] + if not value_allowed_none_or_none_sentinel(request_status, allowed_values): + request_status = 'UNKNOWN_ENUM_VALUE' + self._request_status = request_status + + @property + def time_created(self): + """ + Gets the time_created of this DelegatedResourceAccessRequest. + Time when the Delegated Resource Access Request was created in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegatedResourceAccessRequest. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegatedResourceAccessRequest. + Time when the Delegated Resource Access Request was created in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegatedResourceAccessRequest. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegatedResourceAccessRequest. + Time when the Delegated Resource Access Request was last modified in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegatedResourceAccessRequest. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegatedResourceAccessRequest. + Time when the Delegated Resource Access Request was last modified in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegatedResourceAccessRequest. + :type: datetime + """ + self._time_updated = time_updated + + @property + def num_initial_approvals(self): + """ + Gets the num_initial_approvals of this DelegatedResourceAccessRequest. + Number of initial approvals that have been obtained so far. + + + :return: The num_initial_approvals of this DelegatedResourceAccessRequest. + :rtype: int + """ + return self._num_initial_approvals + + @num_initial_approvals.setter + def num_initial_approvals(self, num_initial_approvals): + """ + Sets the num_initial_approvals of this DelegatedResourceAccessRequest. + Number of initial approvals that have been obtained so far. + + + :param num_initial_approvals: The num_initial_approvals of this DelegatedResourceAccessRequest. + :type: int + """ + self._num_initial_approvals = num_initial_approvals + + @property + def num_extension_approvals(self): + """ + Gets the num_extension_approvals of this DelegatedResourceAccessRequest. + Number of extension approvals that have been obtained so far. + + + :return: The num_extension_approvals of this DelegatedResourceAccessRequest. + :rtype: int + """ + return self._num_extension_approvals + + @num_extension_approvals.setter + def num_extension_approvals(self, num_extension_approvals): + """ + Sets the num_extension_approvals of this DelegatedResourceAccessRequest. + Number of extension approvals that have been obtained so far. + + + :param num_extension_approvals: The num_extension_approvals of this DelegatedResourceAccessRequest. + :type: int + """ + self._num_extension_approvals = num_extension_approvals + + @property + def approval_info(self): + """ + Gets the approval_info of this DelegatedResourceAccessRequest. + In case of single approval, this will have only one item. Else, a list of approvals. + + + :return: The approval_info of this DelegatedResourceAccessRequest. + :rtype: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails] + """ + return self._approval_info + + @approval_info.setter + def approval_info(self, approval_info): + """ + Sets the approval_info of this DelegatedResourceAccessRequest. + In case of single approval, this will have only one item. Else, a list of approvals. + + + :param approval_info: The approval_info of this DelegatedResourceAccessRequest. + :type: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestApprovalDetails] + """ + self._approval_info = approval_info + + @property + def closure_comment(self): + """ + Gets the closure_comment of this DelegatedResourceAccessRequest. + The comment entered by the support operator while closing the request. + + + :return: The closure_comment of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._closure_comment + + @closure_comment.setter + def closure_comment(self, closure_comment): + """ + Sets the closure_comment of this DelegatedResourceAccessRequest. + The comment entered by the support operator while closing the request. + + + :param closure_comment: The closure_comment of this DelegatedResourceAccessRequest. + :type: str + """ + self._closure_comment = closure_comment + + @property + def delegation_control_id(self): + """ + Gets the delegation_control_id of this DelegatedResourceAccessRequest. + The OCID of the Delegation Control governing the target resource. + + + :return: The delegation_control_id of this DelegatedResourceAccessRequest. + :rtype: str + """ + return self._delegation_control_id + + @delegation_control_id.setter + def delegation_control_id(self, delegation_control_id): + """ + Sets the delegation_control_id of this DelegatedResourceAccessRequest. + The OCID of the Delegation Control governing the target resource. + + + :param delegation_control_id: The delegation_control_id of this DelegatedResourceAccessRequest. + :type: str + """ + self._delegation_control_id = delegation_control_id + + @property + def audit_types(self): + """ + Gets the audit_types of this DelegatedResourceAccessRequest. + Specifies the type of auditing to be enabled. There are two levels of auditing: command-level and keystroke-level. + By default, both command-level and keystroke-level auditing are enabled, i.e. commands and key strokes issued by the support operator are logged. + + Allowed values for items in this list are: "COMMAND_AUDIT", "COMMAND_KEYSTROKE_AUDIT", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The audit_types of this DelegatedResourceAccessRequest. + :rtype: list[str] + """ + return self._audit_types + + @audit_types.setter + def audit_types(self, audit_types): + """ + Sets the audit_types of this DelegatedResourceAccessRequest. + Specifies the type of auditing to be enabled. There are two levels of auditing: command-level and keystroke-level. + By default, both command-level and keystroke-level auditing are enabled, i.e. commands and key strokes issued by the support operator are logged. + + + :param audit_types: The audit_types of this DelegatedResourceAccessRequest. + :type: list[str] + """ + allowed_values = ["COMMAND_AUDIT", "COMMAND_KEYSTROKE_AUDIT"] + if audit_types: + audit_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in audit_types] + self._audit_types = audit_types + + @property + def is_pending_more_info(self): + """ + Gets the is_pending_more_info of this DelegatedResourceAccessRequest. + Indicates if the delegated resource access request is waiting on more information from the operator + + + :return: The is_pending_more_info of this DelegatedResourceAccessRequest. + :rtype: bool + """ + return self._is_pending_more_info + + @is_pending_more_info.setter + def is_pending_more_info(self, is_pending_more_info): + """ + Sets the is_pending_more_info of this DelegatedResourceAccessRequest. + Indicates if the delegated resource access request is waiting on more information from the operator + + + :param is_pending_more_info: The is_pending_more_info of this DelegatedResourceAccessRequest. + :type: bool + """ + self._is_pending_more_info = is_pending_more_info + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegatedResourceAccessRequest. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegatedResourceAccessRequest. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegatedResourceAccessRequest. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegatedResourceAccessRequest. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegatedResourceAccessRequest. + 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 DelegatedResourceAccessRequest. + :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 DelegatedResourceAccessRequest. + 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 DelegatedResourceAccessRequest. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegatedResourceAccessRequest. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegatedResourceAccessRequest. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegatedResourceAccessRequest. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegatedResourceAccessRequest. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegated_resource_access_request_approval_details.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_approval_details.py new file mode 100644 index 0000000000..cb09846f90 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_approval_details.py @@ -0,0 +1,263 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestApprovalDetails(object): + """ + Approval info for initial access or extension of a Delegated Resource Access Request + """ + + #: A constant which can be used with the approval_action property of a DelegatedResourceAccessRequestApprovalDetails. + #: This constant has a value of "APPROVE" + APPROVAL_ACTION_APPROVE = "APPROVE" + + #: A constant which can be used with the approval_action property of a DelegatedResourceAccessRequestApprovalDetails. + #: This constant has a value of "REJECT" + APPROVAL_ACTION_REJECT = "REJECT" + + #: A constant which can be used with the approval_type property of a DelegatedResourceAccessRequestApprovalDetails. + #: This constant has a value of "INITIAL" + APPROVAL_TYPE_INITIAL = "INITIAL" + + #: A constant which can be used with the approval_type property of a DelegatedResourceAccessRequestApprovalDetails. + #: This constant has a value of "EXTENSION" + APPROVAL_TYPE_EXTENSION = "EXTENSION" + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestApprovalDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param approval_action: + The value to assign to the approval_action property of this DelegatedResourceAccessRequestApprovalDetails. + Allowed values for this property are: "APPROVE", "REJECT", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type approval_action: str + + :param time_approved_for_access: + The value to assign to the time_approved_for_access property of this DelegatedResourceAccessRequestApprovalDetails. + :type time_approved_for_access: datetime + + :param approval_type: + The value to assign to the approval_type property of this DelegatedResourceAccessRequestApprovalDetails. + Allowed values for this property are: "INITIAL", "EXTENSION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type approval_type: str + + :param approver_comment: + The value to assign to the approver_comment property of this DelegatedResourceAccessRequestApprovalDetails. + :type approver_comment: str + + :param approver_id: + The value to assign to the approver_id property of this DelegatedResourceAccessRequestApprovalDetails. + :type approver_id: str + + :param approver_additional_message: + The value to assign to the approver_additional_message property of this DelegatedResourceAccessRequestApprovalDetails. + :type approver_additional_message: str + + """ + self.swagger_types = { + 'approval_action': 'str', + 'time_approved_for_access': 'datetime', + 'approval_type': 'str', + 'approver_comment': 'str', + 'approver_id': 'str', + 'approver_additional_message': 'str' + } + + self.attribute_map = { + 'approval_action': 'approvalAction', + 'time_approved_for_access': 'timeApprovedForAccess', + 'approval_type': 'approvalType', + 'approver_comment': 'approverComment', + 'approver_id': 'approverId', + 'approver_additional_message': 'approverAdditionalMessage' + } + + self._approval_action = None + self._time_approved_for_access = None + self._approval_type = None + self._approver_comment = None + self._approver_id = None + self._approver_additional_message = None + + @property + def approval_action(self): + """ + Gets the approval_action of this DelegatedResourceAccessRequestApprovalDetails. + Indicated whether the request is approved or rejected. + + Allowed values for this property are: "APPROVE", "REJECT", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The approval_action of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: str + """ + return self._approval_action + + @approval_action.setter + def approval_action(self, approval_action): + """ + Sets the approval_action of this DelegatedResourceAccessRequestApprovalDetails. + Indicated whether the request is approved or rejected. + + + :param approval_action: The approval_action of this DelegatedResourceAccessRequestApprovalDetails. + :type: str + """ + allowed_values = ["APPROVE", "REJECT"] + if not value_allowed_none_or_none_sentinel(approval_action, allowed_values): + approval_action = 'UNKNOWN_ENUM_VALUE' + self._approval_action = approval_action + + @property + def time_approved_for_access(self): + """ + Gets the time_approved_for_access of this DelegatedResourceAccessRequestApprovalDetails. + Access start time that is actually approved by the customer in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_approved_for_access of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: datetime + """ + return self._time_approved_for_access + + @time_approved_for_access.setter + def time_approved_for_access(self, time_approved_for_access): + """ + Sets the time_approved_for_access of this DelegatedResourceAccessRequestApprovalDetails. + Access start time that is actually approved by the customer in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_approved_for_access: The time_approved_for_access of this DelegatedResourceAccessRequestApprovalDetails. + :type: datetime + """ + self._time_approved_for_access = time_approved_for_access + + @property + def approval_type(self): + """ + Gets the approval_type of this DelegatedResourceAccessRequestApprovalDetails. + approval type, initial or extension + + Allowed values for this property are: "INITIAL", "EXTENSION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The approval_type of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: str + """ + return self._approval_type + + @approval_type.setter + def approval_type(self, approval_type): + """ + Sets the approval_type of this DelegatedResourceAccessRequestApprovalDetails. + approval type, initial or extension + + + :param approval_type: The approval_type of this DelegatedResourceAccessRequestApprovalDetails. + :type: str + """ + allowed_values = ["INITIAL", "EXTENSION"] + if not value_allowed_none_or_none_sentinel(approval_type, allowed_values): + approval_type = 'UNKNOWN_ENUM_VALUE' + self._approval_type = approval_type + + @property + def approver_comment(self): + """ + **[Required]** Gets the approver_comment of this DelegatedResourceAccessRequestApprovalDetails. + Comment specified by the approver of the request. + + + :return: The approver_comment of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: str + """ + return self._approver_comment + + @approver_comment.setter + def approver_comment(self, approver_comment): + """ + Sets the approver_comment of this DelegatedResourceAccessRequestApprovalDetails. + Comment specified by the approver of the request. + + + :param approver_comment: The approver_comment of this DelegatedResourceAccessRequestApprovalDetails. + :type: str + """ + self._approver_comment = approver_comment + + @property + def approver_id(self): + """ + Gets the approver_id of this DelegatedResourceAccessRequestApprovalDetails. + User ID of the approver. + + + :return: The approver_id of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: str + """ + return self._approver_id + + @approver_id.setter + def approver_id(self, approver_id): + """ + Sets the approver_id of this DelegatedResourceAccessRequestApprovalDetails. + User ID of the approver. + + + :param approver_id: The approver_id of this DelegatedResourceAccessRequestApprovalDetails. + :type: str + """ + self._approver_id = approver_id + + @property + def approver_additional_message(self): + """ + Gets the approver_additional_message of this DelegatedResourceAccessRequestApprovalDetails. + Additional message specified by the approver of the request. + + + :return: The approver_additional_message of this DelegatedResourceAccessRequestApprovalDetails. + :rtype: str + """ + return self._approver_additional_message + + @approver_additional_message.setter + def approver_additional_message(self, approver_additional_message): + """ + Sets the approver_additional_message of this DelegatedResourceAccessRequestApprovalDetails. + Additional message specified by the approver of the request. + + + :param approver_additional_message: The approver_additional_message of this DelegatedResourceAccessRequestApprovalDetails. + :type: str + """ + self._approver_additional_message = approver_additional_message + + 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/delegate_access_control/models/delegated_resource_access_request_audit_log_report.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_audit_log_report.py new file mode 100644 index 0000000000..65cc6a8e6b --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_audit_log_report.py @@ -0,0 +1,193 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestAuditLogReport(object): + """ + The audit log report details. + """ + + #: A constant which can be used with the audit_report_status property of a DelegatedResourceAccessRequestAuditLogReport. + #: This constant has a value of "NOTAVAILABLE" + AUDIT_REPORT_STATUS_NOTAVAILABLE = "NOTAVAILABLE" + + #: A constant which can be used with the audit_report_status property of a DelegatedResourceAccessRequestAuditLogReport. + #: This constant has a value of "AVAILABLE" + AUDIT_REPORT_STATUS_AVAILABLE = "AVAILABLE" + + #: A constant which can be used with the audit_report_status property of a DelegatedResourceAccessRequestAuditLogReport. + #: This constant has a value of "EXPIRED" + AUDIT_REPORT_STATUS_EXPIRED = "EXPIRED" + + #: A constant which can be used with the audit_report_status property of a DelegatedResourceAccessRequestAuditLogReport. + #: This constant has a value of "FAILED" + AUDIT_REPORT_STATUS_FAILED = "FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestAuditLogReport object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param report: + The value to assign to the report property of this DelegatedResourceAccessRequestAuditLogReport. + :type report: str + + :param process_tree: + The value to assign to the process_tree property of this DelegatedResourceAccessRequestAuditLogReport. + :type process_tree: str + + :param audit_report_status: + The value to assign to the audit_report_status property of this DelegatedResourceAccessRequestAuditLogReport. + Allowed values for this property are: "NOTAVAILABLE", "AVAILABLE", "EXPIRED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type audit_report_status: str + + :param time_report_generated: + The value to assign to the time_report_generated property of this DelegatedResourceAccessRequestAuditLogReport. + :type time_report_generated: datetime + + """ + self.swagger_types = { + 'report': 'str', + 'process_tree': 'str', + 'audit_report_status': 'str', + 'time_report_generated': 'datetime' + } + + self.attribute_map = { + 'report': 'report', + 'process_tree': 'processTree', + 'audit_report_status': 'auditReportStatus', + 'time_report_generated': 'timeReportGenerated' + } + + self._report = None + self._process_tree = None + self._audit_report_status = None + self._time_report_generated = None + + @property + def report(self): + """ + Gets the report of this DelegatedResourceAccessRequestAuditLogReport. + Audit log report. + + + :return: The report of this DelegatedResourceAccessRequestAuditLogReport. + :rtype: str + """ + return self._report + + @report.setter + def report(self, report): + """ + Sets the report of this DelegatedResourceAccessRequestAuditLogReport. + Audit log report. + + + :param report: The report of this DelegatedResourceAccessRequestAuditLogReport. + :type: str + """ + self._report = report + + @property + def process_tree(self): + """ + Gets the process_tree of this DelegatedResourceAccessRequestAuditLogReport. + The process tree data + + + :return: The process_tree of this DelegatedResourceAccessRequestAuditLogReport. + :rtype: str + """ + return self._process_tree + + @process_tree.setter + def process_tree(self, process_tree): + """ + Sets the process_tree of this DelegatedResourceAccessRequestAuditLogReport. + The process tree data + + + :param process_tree: The process_tree of this DelegatedResourceAccessRequestAuditLogReport. + :type: str + """ + self._process_tree = process_tree + + @property + def audit_report_status(self): + """ + **[Required]** Gets the audit_report_status of this DelegatedResourceAccessRequestAuditLogReport. + Status of the audit report + + Allowed values for this property are: "NOTAVAILABLE", "AVAILABLE", "EXPIRED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The audit_report_status of this DelegatedResourceAccessRequestAuditLogReport. + :rtype: str + """ + return self._audit_report_status + + @audit_report_status.setter + def audit_report_status(self, audit_report_status): + """ + Sets the audit_report_status of this DelegatedResourceAccessRequestAuditLogReport. + Status of the audit report + + + :param audit_report_status: The audit_report_status of this DelegatedResourceAccessRequestAuditLogReport. + :type: str + """ + allowed_values = ["NOTAVAILABLE", "AVAILABLE", "EXPIRED", "FAILED"] + if not value_allowed_none_or_none_sentinel(audit_report_status, allowed_values): + audit_report_status = 'UNKNOWN_ENUM_VALUE' + self._audit_report_status = audit_report_status + + @property + def time_report_generated(self): + """ + Gets the time_report_generated of this DelegatedResourceAccessRequestAuditLogReport. + Time when the audit report was generated `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_report_generated of this DelegatedResourceAccessRequestAuditLogReport. + :rtype: datetime + """ + return self._time_report_generated + + @time_report_generated.setter + def time_report_generated(self, time_report_generated): + """ + Sets the time_report_generated of this DelegatedResourceAccessRequestAuditLogReport. + Time when the audit report was generated `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_report_generated: The time_report_generated of this DelegatedResourceAccessRequestAuditLogReport. + :type: datetime + """ + self._time_report_generated = time_report_generated + + 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/delegate_access_control/models/delegated_resource_access_request_history_collection.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_history_collection.py new file mode 100644 index 0000000000..abf4f1d75f --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_history_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestHistoryCollection(object): + """ + List of Delegated Resource Access Request status transitions. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestHistoryCollection 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 DelegatedResourceAccessRequestHistoryCollection. + :type items: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary] + + """ + self.swagger_types = { + 'items': 'list[DelegatedResourceAccessRequestHistorySummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this DelegatedResourceAccessRequestHistoryCollection. + List of DelegatedResourceAccessRequestHistorySummary objects. + + + :return: The items of this DelegatedResourceAccessRequestHistoryCollection. + :rtype: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this DelegatedResourceAccessRequestHistoryCollection. + List of DelegatedResourceAccessRequestHistorySummary objects. + + + :param items: The items of this DelegatedResourceAccessRequestHistoryCollection. + :type: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestHistorySummary] + """ + 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/delegate_access_control/models/delegated_resource_access_request_history_summary.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_history_summary.py new file mode 100644 index 0000000000..8a5130cc82 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_history_summary.py @@ -0,0 +1,300 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestHistorySummary(object): + """ + Summary of Delegated Resource Access Request status changes. + """ + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "CREATED" + REQUEST_STATUS_CREATED = "CREATED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "APPROVAL_WAITING" + REQUEST_STATUS_APPROVAL_WAITING = "APPROVAL_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "OPERATOR_ASSIGNMENT_WAITING" + REQUEST_STATUS_OPERATOR_ASSIGNMENT_WAITING = "OPERATOR_ASSIGNMENT_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "PREAPPROVED" + REQUEST_STATUS_PREAPPROVED = "PREAPPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "APPROVED" + REQUEST_STATUS_APPROVED = "APPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "APPROVED_FOR_FUTURE" + REQUEST_STATUS_APPROVED_FOR_FUTURE = "APPROVED_FOR_FUTURE" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "REJECTED" + REQUEST_STATUS_REJECTED = "REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "DEPLOYED" + REQUEST_STATUS_DEPLOYED = "DEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "DEPLOY_FAILED" + REQUEST_STATUS_DEPLOY_FAILED = "DEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "UNDEPLOYED" + REQUEST_STATUS_UNDEPLOYED = "UNDEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "UNDEPLOY_FAILED" + REQUEST_STATUS_UNDEPLOY_FAILED = "UNDEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "CLOSE_FAILED" + REQUEST_STATUS_CLOSE_FAILED = "CLOSE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "REVOKE_FAILED" + REQUEST_STATUS_REVOKE_FAILED = "REVOKE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXPIRY_FAILED" + REQUEST_STATUS_EXPIRY_FAILED = "EXPIRY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "REVOKING" + REQUEST_STATUS_REVOKING = "REVOKING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "REVOKED" + REQUEST_STATUS_REVOKED = "REVOKED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXTENDING" + REQUEST_STATUS_EXTENDING = "EXTENDING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXTENDED" + REQUEST_STATUS_EXTENDED = "EXTENDED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXTENSION_REJECTED" + REQUEST_STATUS_EXTENSION_REJECTED = "EXTENSION_REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXTENSION_FAILED" + REQUEST_STATUS_EXTENSION_FAILED = "EXTENSION_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "COMPLETING" + REQUEST_STATUS_COMPLETING = "COMPLETING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "COMPLETED" + REQUEST_STATUS_COMPLETED = "COMPLETED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestHistorySummary. + #: This constant has a value of "EXPIRED" + REQUEST_STATUS_EXPIRED = "EXPIRED" + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestHistorySummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegatedResourceAccessRequestHistorySummary. + :type lifecycle_state: str + + :param request_status: + The value to assign to the request_status property of this DelegatedResourceAccessRequestHistorySummary. + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type request_status: str + + :param user_id: + The value to assign to the user_id property of this DelegatedResourceAccessRequestHistorySummary. + :type user_id: str + + :param comment: + The value to assign to the comment property of this DelegatedResourceAccessRequestHistorySummary. + :type comment: str + + :param timestamp: + The value to assign to the timestamp property of this DelegatedResourceAccessRequestHistorySummary. + :type timestamp: datetime + + """ + self.swagger_types = { + 'lifecycle_state': 'str', + 'request_status': 'str', + 'user_id': 'str', + 'comment': 'str', + 'timestamp': 'datetime' + } + + self.attribute_map = { + 'lifecycle_state': 'lifecycleState', + 'request_status': 'requestStatus', + 'user_id': 'userId', + 'comment': 'comment', + 'timestamp': 'timestamp' + } + + self._lifecycle_state = None + self._request_status = None + self._user_id = None + self._comment = None + self._timestamp = None + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegatedResourceAccessRequestHistorySummary. + The current lifecycle state of the Delegated Resource Access Request. + + + :return: The lifecycle_state of this DelegatedResourceAccessRequestHistorySummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegatedResourceAccessRequestHistorySummary. + The current lifecycle state of the Delegated Resource Access Request. + + + :param lifecycle_state: The lifecycle_state of this DelegatedResourceAccessRequestHistorySummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def request_status(self): + """ + Gets the request_status of this DelegatedResourceAccessRequestHistorySummary. + The current status of the Delegated Resource Access Request. + + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The request_status of this DelegatedResourceAccessRequestHistorySummary. + :rtype: str + """ + return self._request_status + + @request_status.setter + def request_status(self, request_status): + """ + Sets the request_status of this DelegatedResourceAccessRequestHistorySummary. + The current status of the Delegated Resource Access Request. + + + :param request_status: The request_status of this DelegatedResourceAccessRequestHistorySummary. + :type: str + """ + allowed_values = ["CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED"] + if not value_allowed_none_or_none_sentinel(request_status, allowed_values): + request_status = 'UNKNOWN_ENUM_VALUE' + self._request_status = request_status + + @property + def user_id(self): + """ + Gets the user_id of this DelegatedResourceAccessRequestHistorySummary. + ID of user who modified the Delegated Resource Access Request. For operator, this field is \"Operator\". + + + :return: The user_id of this DelegatedResourceAccessRequestHistorySummary. + :rtype: str + """ + return self._user_id + + @user_id.setter + def user_id(self, user_id): + """ + Sets the user_id of this DelegatedResourceAccessRequestHistorySummary. + ID of user who modified the Delegated Resource Access Request. For operator, this field is \"Operator\". + + + :param user_id: The user_id of this DelegatedResourceAccessRequestHistorySummary. + :type: str + """ + self._user_id = user_id + + @property + def comment(self): + """ + Gets the comment of this DelegatedResourceAccessRequestHistorySummary. + Comment about the status change. + + + :return: The comment of this DelegatedResourceAccessRequestHistorySummary. + :rtype: str + """ + return self._comment + + @comment.setter + def comment(self, comment): + """ + Sets the comment of this DelegatedResourceAccessRequestHistorySummary. + Comment about the status change. + + + :param comment: The comment of this DelegatedResourceAccessRequestHistorySummary. + :type: str + """ + self._comment = comment + + @property + def timestamp(self): + """ + Gets the timestamp of this DelegatedResourceAccessRequestHistorySummary. + Time when the respective action happened in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The timestamp of this DelegatedResourceAccessRequestHistorySummary. + :rtype: datetime + """ + return self._timestamp + + @timestamp.setter + def timestamp(self, timestamp): + """ + Sets the timestamp of this DelegatedResourceAccessRequestHistorySummary. + Time when the respective action happened in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param timestamp: The timestamp of this DelegatedResourceAccessRequestHistorySummary. + :type: datetime + """ + self._timestamp = timestamp + + 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/delegate_access_control/models/delegated_resource_access_request_summary.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_summary.py new file mode 100644 index 0000000000..199678de23 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_summary.py @@ -0,0 +1,981 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestSummary(object): + """ + Summary of Delegated Resource Access Request. + """ + + #: A constant which can be used with the resource_type property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "OPERATOR" + REQUESTER_TYPE_OPERATOR = "OPERATOR" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "CUSTOMER" + REQUESTER_TYPE_CUSTOMER = "CUSTOMER" + + #: A constant which can be used with the requester_type property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "SYSTEM" + REQUESTER_TYPE_SYSTEM = "SYSTEM" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "S1" + SEVERITY_S1 = "S1" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "S2" + SEVERITY_S2 = "S2" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "S3" + SEVERITY_S3 = "S3" + + #: A constant which can be used with the severity property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "S4" + SEVERITY_S4 = "S4" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "CREATED" + REQUEST_STATUS_CREATED = "CREATED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "APPROVAL_WAITING" + REQUEST_STATUS_APPROVAL_WAITING = "APPROVAL_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "OPERATOR_ASSIGNMENT_WAITING" + REQUEST_STATUS_OPERATOR_ASSIGNMENT_WAITING = "OPERATOR_ASSIGNMENT_WAITING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "PREAPPROVED" + REQUEST_STATUS_PREAPPROVED = "PREAPPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "APPROVED" + REQUEST_STATUS_APPROVED = "APPROVED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "APPROVED_FOR_FUTURE" + REQUEST_STATUS_APPROVED_FOR_FUTURE = "APPROVED_FOR_FUTURE" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "REJECTED" + REQUEST_STATUS_REJECTED = "REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "DEPLOYED" + REQUEST_STATUS_DEPLOYED = "DEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "DEPLOY_FAILED" + REQUEST_STATUS_DEPLOY_FAILED = "DEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "UNDEPLOYED" + REQUEST_STATUS_UNDEPLOYED = "UNDEPLOYED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "UNDEPLOY_FAILED" + REQUEST_STATUS_UNDEPLOY_FAILED = "UNDEPLOY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "CLOSE_FAILED" + REQUEST_STATUS_CLOSE_FAILED = "CLOSE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "REVOKE_FAILED" + REQUEST_STATUS_REVOKE_FAILED = "REVOKE_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXPIRY_FAILED" + REQUEST_STATUS_EXPIRY_FAILED = "EXPIRY_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "REVOKING" + REQUEST_STATUS_REVOKING = "REVOKING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "REVOKED" + REQUEST_STATUS_REVOKED = "REVOKED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXTENDING" + REQUEST_STATUS_EXTENDING = "EXTENDING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXTENDED" + REQUEST_STATUS_EXTENDED = "EXTENDED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXTENSION_REJECTED" + REQUEST_STATUS_EXTENSION_REJECTED = "EXTENSION_REJECTED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXTENSION_FAILED" + REQUEST_STATUS_EXTENSION_FAILED = "EXTENSION_FAILED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "COMPLETING" + REQUEST_STATUS_COMPLETING = "COMPLETING" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "COMPLETED" + REQUEST_STATUS_COMPLETED = "COMPLETED" + + #: A constant which can be used with the request_status property of a DelegatedResourceAccessRequestSummary. + #: This constant has a value of "EXPIRED" + REQUEST_STATUS_EXPIRED = "EXPIRED" + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestSummary 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 DelegatedResourceAccessRequestSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegatedResourceAccessRequestSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this DelegatedResourceAccessRequestSummary. + :type display_name: str + + :param ticket_numbers: + The value to assign to the ticket_numbers property of this DelegatedResourceAccessRequestSummary. + :type ticket_numbers: list[str] + + :param reason_for_request: + The value to assign to the reason_for_request property of this DelegatedResourceAccessRequestSummary. + :type reason_for_request: str + + :param time_access_requested: + The value to assign to the time_access_requested property of this DelegatedResourceAccessRequestSummary. + :type time_access_requested: datetime + + :param resource_id: + The value to assign to the resource_id property of this DelegatedResourceAccessRequestSummary. + :type resource_id: str + + :param resource_name: + The value to assign to the resource_name property of this DelegatedResourceAccessRequestSummary. + :type resource_name: str + + :param resource_type: + The value to assign to the resource_type property of this DelegatedResourceAccessRequestSummary. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param requested_action_names: + The value to assign to the requested_action_names property of this DelegatedResourceAccessRequestSummary. + :type requested_action_names: list[str] + + :param requester_type: + The value to assign to the requester_type property of this DelegatedResourceAccessRequestSummary. + Allowed values for this property are: "OPERATOR", "CUSTOMER", "SYSTEM", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type requester_type: str + + :param delegation_control_id: + The value to assign to the delegation_control_id property of this DelegatedResourceAccessRequestSummary. + :type delegation_control_id: str + + :param severity: + The value to assign to the severity property of this DelegatedResourceAccessRequestSummary. + Allowed values for this property are: "S1", "S2", "S3", "S4", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type severity: str + + :param duration_in_hours: + The value to assign to the duration_in_hours property of this DelegatedResourceAccessRequestSummary. + :type duration_in_hours: int + + :param extend_duration_in_hours: + The value to assign to the extend_duration_in_hours property of this DelegatedResourceAccessRequestSummary. + :type extend_duration_in_hours: int + + :param is_auto_approved: + The value to assign to the is_auto_approved property of this DelegatedResourceAccessRequestSummary. + :type is_auto_approved: bool + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegatedResourceAccessRequestSummary. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegatedResourceAccessRequestSummary. + :type lifecycle_state_details: str + + :param request_status: + The value to assign to the request_status property of this DelegatedResourceAccessRequestSummary. + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type request_status: str + + :param time_created: + The value to assign to the time_created property of this DelegatedResourceAccessRequestSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegatedResourceAccessRequestSummary. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegatedResourceAccessRequestSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegatedResourceAccessRequestSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegatedResourceAccessRequestSummary. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'ticket_numbers': 'list[str]', + 'reason_for_request': 'str', + 'time_access_requested': 'datetime', + 'resource_id': 'str', + 'resource_name': 'str', + 'resource_type': 'str', + 'requested_action_names': 'list[str]', + 'requester_type': 'str', + 'delegation_control_id': 'str', + 'severity': 'str', + 'duration_in_hours': 'int', + 'extend_duration_in_hours': 'int', + 'is_auto_approved': 'bool', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'request_status': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'ticket_numbers': 'ticketNumbers', + 'reason_for_request': 'reasonForRequest', + 'time_access_requested': 'timeAccessRequested', + 'resource_id': 'resourceId', + 'resource_name': 'resourceName', + 'resource_type': 'resourceType', + 'requested_action_names': 'requestedActionNames', + 'requester_type': 'requesterType', + 'delegation_control_id': 'delegationControlId', + 'severity': 'severity', + 'duration_in_hours': 'durationInHours', + 'extend_duration_in_hours': 'extendDurationInHours', + 'is_auto_approved': 'isAutoApproved', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'request_status': 'requestStatus', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._ticket_numbers = None + self._reason_for_request = None + self._time_access_requested = None + self._resource_id = None + self._resource_name = None + self._resource_type = None + self._requested_action_names = None + self._requester_type = None + self._delegation_control_id = None + self._severity = None + self._duration_in_hours = None + self._extend_duration_in_hours = None + self._is_auto_approved = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._request_status = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegatedResourceAccessRequestSummary. + The OCID of the Delegated Resource Access Request. + + + :return: The id of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegatedResourceAccessRequestSummary. + The OCID of the Delegated Resource Access Request. + + + :param id: The id of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this DelegatedResourceAccessRequestSummary. + The OCID of the compartment that contains the Delegated Resource Access Request. + + + :return: The compartment_id of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegatedResourceAccessRequestSummary. + The OCID of the compartment that contains the Delegated Resource Access Request. + + + :param compartment_id: The compartment_id of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this DelegatedResourceAccessRequestSummary. + Display name. This is generated by the system automatically. + + + :return: The display_name of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegatedResourceAccessRequestSummary. + Display name. This is generated by the system automatically. + + + :param display_name: The display_name of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._display_name = display_name + + @property + def ticket_numbers(self): + """ + Gets the ticket_numbers of this DelegatedResourceAccessRequestSummary. + A list of ticket numbers related to this Delegated Resource Access Request, e.g. Service Request (SR) number and JIRA ticket number. + + + :return: The ticket_numbers of this DelegatedResourceAccessRequestSummary. + :rtype: list[str] + """ + return self._ticket_numbers + + @ticket_numbers.setter + def ticket_numbers(self, ticket_numbers): + """ + Sets the ticket_numbers of this DelegatedResourceAccessRequestSummary. + A list of ticket numbers related to this Delegated Resource Access Request, e.g. Service Request (SR) number and JIRA ticket number. + + + :param ticket_numbers: The ticket_numbers of this DelegatedResourceAccessRequestSummary. + :type: list[str] + """ + self._ticket_numbers = ticket_numbers + + @property + def reason_for_request(self): + """ + **[Required]** Gets the reason_for_request of this DelegatedResourceAccessRequestSummary. + A short description explaining why this Delegated Resource Access Request is needed by the support operator. + + + :return: The reason_for_request of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._reason_for_request + + @reason_for_request.setter + def reason_for_request(self, reason_for_request): + """ + Sets the reason_for_request of this DelegatedResourceAccessRequestSummary. + A short description explaining why this Delegated Resource Access Request is needed by the support operator. + + + :param reason_for_request: The reason_for_request of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._reason_for_request = reason_for_request + + @property + def time_access_requested(self): + """ + Gets the time_access_requested of this DelegatedResourceAccessRequestSummary. + Requested access start time in UTC. + + + :return: The time_access_requested of this DelegatedResourceAccessRequestSummary. + :rtype: datetime + """ + return self._time_access_requested + + @time_access_requested.setter + def time_access_requested(self, time_access_requested): + """ + Sets the time_access_requested of this DelegatedResourceAccessRequestSummary. + Requested access start time in UTC. + + + :param time_access_requested: The time_access_requested of this DelegatedResourceAccessRequestSummary. + :type: datetime + """ + self._time_access_requested = time_access_requested + + @property + def resource_id(self): + """ + **[Required]** Gets the resource_id of this DelegatedResourceAccessRequestSummary. + The OCID of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :return: The resource_id of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._resource_id + + @resource_id.setter + def resource_id(self, resource_id): + """ + Sets the resource_id of this DelegatedResourceAccessRequestSummary. + The OCID of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :param resource_id: The resource_id of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._resource_id = resource_id + + @property + def resource_name(self): + """ + Gets the resource_name of this DelegatedResourceAccessRequestSummary. + The name of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :return: The resource_name of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._resource_name + + @resource_name.setter + def resource_name(self, resource_name): + """ + Sets the resource_name of this DelegatedResourceAccessRequestSummary. + The name of the target resource associated with the Delegated Resource Access Request. The support operator raises a Delegated Resource Access Request to get approval to + access the target resource. + + + :param resource_name: The resource_name of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._resource_name = resource_name + + @property + def resource_type(self): + """ + Gets the resource_type of this DelegatedResourceAccessRequestSummary. + Resource type for which the associated Delegation Control is applicable to. + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this DelegatedResourceAccessRequestSummary. + Resource type for which the associated Delegation Control is applicable to. + + + :param resource_type: The resource_type of this DelegatedResourceAccessRequestSummary. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def requested_action_names(self): + """ + Gets the requested_action_names of this DelegatedResourceAccessRequestSummary. + List of Service Provider Action names for which approval is sought by the support operator user. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. + + + :return: The requested_action_names of this DelegatedResourceAccessRequestSummary. + :rtype: list[str] + """ + return self._requested_action_names + + @requested_action_names.setter + def requested_action_names(self, requested_action_names): + """ + Sets the requested_action_names of this DelegatedResourceAccessRequestSummary. + List of Service Provider Action names for which approval is sought by the support operator user. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. + + + :param requested_action_names: The requested_action_names of this DelegatedResourceAccessRequestSummary. + :type: list[str] + """ + self._requested_action_names = requested_action_names + + @property + def requester_type(self): + """ + Gets the requester_type of this DelegatedResourceAccessRequestSummary. + Requester type + + Allowed values for this property are: "OPERATOR", "CUSTOMER", "SYSTEM", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The requester_type of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._requester_type + + @requester_type.setter + def requester_type(self, requester_type): + """ + Sets the requester_type of this DelegatedResourceAccessRequestSummary. + Requester type + + + :param requester_type: The requester_type of this DelegatedResourceAccessRequestSummary. + :type: str + """ + allowed_values = ["OPERATOR", "CUSTOMER", "SYSTEM"] + if not value_allowed_none_or_none_sentinel(requester_type, allowed_values): + requester_type = 'UNKNOWN_ENUM_VALUE' + self._requester_type = requester_type + + @property + def delegation_control_id(self): + """ + **[Required]** Gets the delegation_control_id of this DelegatedResourceAccessRequestSummary. + The OCID of the Delegation Control governing the target resource. + + + :return: The delegation_control_id of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._delegation_control_id + + @delegation_control_id.setter + def delegation_control_id(self, delegation_control_id): + """ + Sets the delegation_control_id of this DelegatedResourceAccessRequestSummary. + The OCID of the Delegation Control governing the target resource. + + + :param delegation_control_id: The delegation_control_id of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._delegation_control_id = delegation_control_id + + @property + def severity(self): + """ + Gets the severity of this DelegatedResourceAccessRequestSummary. + Priority assigned to the Delegated Resource Access Request by the support operator + + Allowed values for this property are: "S1", "S2", "S3", "S4", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The severity of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._severity + + @severity.setter + def severity(self, severity): + """ + Sets the severity of this DelegatedResourceAccessRequestSummary. + Priority assigned to the Delegated Resource Access Request by the support operator + + + :param severity: The severity of this DelegatedResourceAccessRequestSummary. + :type: str + """ + allowed_values = ["S1", "S2", "S3", "S4"] + if not value_allowed_none_or_none_sentinel(severity, allowed_values): + severity = 'UNKNOWN_ENUM_VALUE' + self._severity = severity + + @property + def duration_in_hours(self): + """ + Gets the duration_in_hours of this DelegatedResourceAccessRequestSummary. + Duration in hours for which access is sought on the target resource. + + + :return: The duration_in_hours of this DelegatedResourceAccessRequestSummary. + :rtype: int + """ + return self._duration_in_hours + + @duration_in_hours.setter + def duration_in_hours(self, duration_in_hours): + """ + Sets the duration_in_hours of this DelegatedResourceAccessRequestSummary. + Duration in hours for which access is sought on the target resource. + + + :param duration_in_hours: The duration_in_hours of this DelegatedResourceAccessRequestSummary. + :type: int + """ + self._duration_in_hours = duration_in_hours + + @property + def extend_duration_in_hours(self): + """ + Gets the extend_duration_in_hours of this DelegatedResourceAccessRequestSummary. + Duration in hours for which extension access is sought on the target resource. + + + :return: The extend_duration_in_hours of this DelegatedResourceAccessRequestSummary. + :rtype: int + """ + return self._extend_duration_in_hours + + @extend_duration_in_hours.setter + def extend_duration_in_hours(self, extend_duration_in_hours): + """ + Sets the extend_duration_in_hours of this DelegatedResourceAccessRequestSummary. + Duration in hours for which extension access is sought on the target resource. + + + :param extend_duration_in_hours: The extend_duration_in_hours of this DelegatedResourceAccessRequestSummary. + :type: int + """ + self._extend_duration_in_hours = extend_duration_in_hours + + @property + def is_auto_approved(self): + """ + Gets the is_auto_approved of this DelegatedResourceAccessRequestSummary. + Set to true if the request is approved automatically based on preApprovedServiceProviderActionNames or isAutoApproveDuringMaintenance in the associated Delegation Control. + + + :return: The is_auto_approved of this DelegatedResourceAccessRequestSummary. + :rtype: bool + """ + return self._is_auto_approved + + @is_auto_approved.setter + def is_auto_approved(self, is_auto_approved): + """ + Sets the is_auto_approved of this DelegatedResourceAccessRequestSummary. + Set to true if the request is approved automatically based on preApprovedServiceProviderActionNames or isAutoApproveDuringMaintenance in the associated Delegation Control. + + + :param is_auto_approved: The is_auto_approved of this DelegatedResourceAccessRequestSummary. + :type: bool + """ + self._is_auto_approved = is_auto_approved + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegatedResourceAccessRequestSummary. + The current lifecycle state of the Delegated Resource Access Request. + + + :return: The lifecycle_state of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegatedResourceAccessRequestSummary. + The current lifecycle state of the Delegated Resource Access Request. + + + :param lifecycle_state: The lifecycle_state of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_state_details(self): + """ + Gets the lifecycle_state_details of this DelegatedResourceAccessRequestSummary. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegatedResourceAccessRequestSummary. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegatedResourceAccessRequestSummary. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def request_status(self): + """ + Gets the request_status of this DelegatedResourceAccessRequestSummary. + The current status of the Delegated Resource Access Request. + + Allowed values for this property are: "CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The request_status of this DelegatedResourceAccessRequestSummary. + :rtype: str + """ + return self._request_status + + @request_status.setter + def request_status(self, request_status): + """ + Sets the request_status of this DelegatedResourceAccessRequestSummary. + The current status of the Delegated Resource Access Request. + + + :param request_status: The request_status of this DelegatedResourceAccessRequestSummary. + :type: str + """ + allowed_values = ["CREATED", "APPROVAL_WAITING", "OPERATOR_ASSIGNMENT_WAITING", "PREAPPROVED", "APPROVED", "APPROVED_FOR_FUTURE", "REJECTED", "DEPLOYED", "DEPLOY_FAILED", "UNDEPLOYED", "UNDEPLOY_FAILED", "CLOSE_FAILED", "REVOKE_FAILED", "EXPIRY_FAILED", "REVOKING", "REVOKED", "EXTENDING", "EXTENDED", "EXTENSION_REJECTED", "EXTENSION_FAILED", "COMPLETING", "COMPLETED", "EXPIRED"] + if not value_allowed_none_or_none_sentinel(request_status, allowed_values): + request_status = 'UNKNOWN_ENUM_VALUE' + self._request_status = request_status + + @property + def time_created(self): + """ + Gets the time_created of this DelegatedResourceAccessRequestSummary. + Time when the Delegated Resource Access Request was created by the support operator user in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegatedResourceAccessRequestSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegatedResourceAccessRequestSummary. + Time when the Delegated Resource Access Request was created by the support operator user in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegatedResourceAccessRequestSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegatedResourceAccessRequestSummary. + Time when the Delegated Resource Access Request was last modified in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegatedResourceAccessRequestSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegatedResourceAccessRequestSummary. + Time when the Delegated Resource Access Request was last modified in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegatedResourceAccessRequestSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegatedResourceAccessRequestSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegatedResourceAccessRequestSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegatedResourceAccessRequestSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegatedResourceAccessRequestSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegatedResourceAccessRequestSummary. + 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 DelegatedResourceAccessRequestSummary. + :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 DelegatedResourceAccessRequestSummary. + 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 DelegatedResourceAccessRequestSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegatedResourceAccessRequestSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegatedResourceAccessRequestSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegatedResourceAccessRequestSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegatedResourceAccessRequestSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegated_resource_access_request_summary_collection.py b/src/oci/delegate_access_control/models/delegated_resource_access_request_summary_collection.py new file mode 100644 index 0000000000..fd3877f418 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegated_resource_access_request_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegatedResourceAccessRequestSummaryCollection(object): + """ + Results of Delegated Resource Access Request search, which contains summary of Delegated Resource Access Request. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DelegatedResourceAccessRequestSummaryCollection 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 DelegatedResourceAccessRequestSummaryCollection. + :type items: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary] + + """ + self.swagger_types = { + 'items': 'list[DelegatedResourceAccessRequestSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this DelegatedResourceAccessRequestSummaryCollection. + contains DelegatedResourceAccessRequestSummary + + + :return: The items of this DelegatedResourceAccessRequestSummaryCollection. + :rtype: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this DelegatedResourceAccessRequestSummaryCollection. + contains DelegatedResourceAccessRequestSummary + + + :param items: The items of this DelegatedResourceAccessRequestSummaryCollection. + :type: list[oci.delegate_access_control.models.DelegatedResourceAccessRequestSummary] + """ + 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/delegate_access_control/models/delegation_control.py b/src/oci/delegate_access_control/models/delegation_control.py new file mode 100644 index 0000000000..33386ee29c --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_control.py @@ -0,0 +1,833 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationControl(object): + """ + Delegation Control enables you to grant, audit, or revoke the access Oracle has to your Exadata Cloud infrastructure, and obtain audit reports of all actions taken by a human operator, in a near real-time manner. + """ + + #: A constant which can be used with the resource_type property of a DelegationControl. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a DelegationControl. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the notification_message_format property of a DelegationControl. + #: This constant has a value of "JSON" + NOTIFICATION_MESSAGE_FORMAT_JSON = "JSON" + + #: A constant which can be used with the notification_message_format property of a DelegationControl. + #: This constant has a value of "HTML" + NOTIFICATION_MESSAGE_FORMAT_HTML = "HTML" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + #: A constant which can be used with the lifecycle_state property of a DelegationControl. + #: This constant has a value of "NEEDS_ATTENTION" + LIFECYCLE_STATE_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + def __init__(self, **kwargs): + """ + Initializes a new DelegationControl 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 DelegationControl. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegationControl. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this DelegationControl. + :type display_name: str + + :param description: + The value to assign to the description property of this DelegationControl. + :type description: str + + :param num_approvals_required: + The value to assign to the num_approvals_required property of this DelegationControl. + :type num_approvals_required: int + + :param pre_approved_service_provider_action_names: + The value to assign to the pre_approved_service_provider_action_names property of this DelegationControl. + :type pre_approved_service_provider_action_names: list[str] + + :param delegation_subscription_ids: + The value to assign to the delegation_subscription_ids property of this DelegationControl. + :type delegation_subscription_ids: list[str] + + :param is_auto_approve_during_maintenance: + The value to assign to the is_auto_approve_during_maintenance property of this DelegationControl. + :type is_auto_approve_during_maintenance: bool + + :param resource_ids: + The value to assign to the resource_ids property of this DelegationControl. + :type resource_ids: list[str] + + :param resource_type: + The value to assign to the resource_type property of this DelegationControl. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param notification_topic_id: + The value to assign to the notification_topic_id property of this DelegationControl. + :type notification_topic_id: str + + :param notification_message_format: + The value to assign to the notification_message_format property of this DelegationControl. + Allowed values for this property are: "JSON", "HTML", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type notification_message_format: str + + :param vault_id: + The value to assign to the vault_id property of this DelegationControl. + :type vault_id: str + + :param vault_key_id: + The value to assign to the vault_key_id property of this DelegationControl. + :type vault_key_id: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegationControl. + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegationControl. + :type lifecycle_state_details: str + + :param time_created: + The value to assign to the time_created property of this DelegationControl. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegationControl. + :type time_updated: datetime + + :param time_deleted: + The value to assign to the time_deleted property of this DelegationControl. + :type time_deleted: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegationControl. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegationControl. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegationControl. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'description': 'str', + 'num_approvals_required': 'int', + 'pre_approved_service_provider_action_names': 'list[str]', + 'delegation_subscription_ids': 'list[str]', + 'is_auto_approve_during_maintenance': 'bool', + 'resource_ids': 'list[str]', + 'resource_type': 'str', + 'notification_topic_id': 'str', + 'notification_message_format': 'str', + 'vault_id': 'str', + 'vault_key_id': 'str', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'time_deleted': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'description': 'description', + 'num_approvals_required': 'numApprovalsRequired', + 'pre_approved_service_provider_action_names': 'preApprovedServiceProviderActionNames', + 'delegation_subscription_ids': 'delegationSubscriptionIds', + 'is_auto_approve_during_maintenance': 'isAutoApproveDuringMaintenance', + 'resource_ids': 'resourceIds', + 'resource_type': 'resourceType', + 'notification_topic_id': 'notificationTopicId', + 'notification_message_format': 'notificationMessageFormat', + 'vault_id': 'vaultId', + 'vault_key_id': 'vaultKeyId', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'time_deleted': 'timeDeleted', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._description = None + self._num_approvals_required = None + self._pre_approved_service_provider_action_names = None + self._delegation_subscription_ids = None + self._is_auto_approve_during_maintenance = None + self._resource_ids = None + self._resource_type = None + self._notification_topic_id = None + self._notification_message_format = None + self._vault_id = None + self._vault_key_id = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._time_created = None + self._time_updated = None + self._time_deleted = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegationControl. + The OCID of the Delegation Control. + + + :return: The id of this DelegationControl. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegationControl. + The OCID of the Delegation Control. + + + :param id: The id of this DelegationControl. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this DelegationControl. + The OCID of the compartment that contains the Delegation Control. + + + :return: The compartment_id of this DelegationControl. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegationControl. + The OCID of the compartment that contains the Delegation Control. + + + :param compartment_id: The compartment_id of this DelegationControl. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this DelegationControl. + Name of the Delegation Control. The name does not need to be unique. + + + :return: The display_name of this DelegationControl. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegationControl. + Name of the Delegation Control. The name does not need to be unique. + + + :param display_name: The display_name of this DelegationControl. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this DelegationControl. + Description of the Delegation Control. + + + :return: The description of this DelegationControl. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this DelegationControl. + Description of the Delegation Control. + + + :param description: The description of this DelegationControl. + :type: str + """ + self._description = description + + @property + def num_approvals_required(self): + """ + Gets the num_approvals_required of this DelegationControl. + number of approvals required. + + + :return: The num_approvals_required of this DelegationControl. + :rtype: int + """ + return self._num_approvals_required + + @num_approvals_required.setter + def num_approvals_required(self, num_approvals_required): + """ + Sets the num_approvals_required of this DelegationControl. + number of approvals required. + + + :param num_approvals_required: The num_approvals_required of this DelegationControl. + :type: int + """ + self._num_approvals_required = num_approvals_required + + @property + def pre_approved_service_provider_action_names(self): + """ + Gets the pre_approved_service_provider_action_names of this DelegationControl. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :return: The pre_approved_service_provider_action_names of this DelegationControl. + :rtype: list[str] + """ + return self._pre_approved_service_provider_action_names + + @pre_approved_service_provider_action_names.setter + def pre_approved_service_provider_action_names(self, pre_approved_service_provider_action_names): + """ + Sets the pre_approved_service_provider_action_names of this DelegationControl. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :param pre_approved_service_provider_action_names: The pre_approved_service_provider_action_names of this DelegationControl. + :type: list[str] + """ + self._pre_approved_service_provider_action_names = pre_approved_service_provider_action_names + + @property + def delegation_subscription_ids(self): + """ + Gets the delegation_subscription_ids of this DelegationControl. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :return: The delegation_subscription_ids of this DelegationControl. + :rtype: list[str] + """ + return self._delegation_subscription_ids + + @delegation_subscription_ids.setter + def delegation_subscription_ids(self, delegation_subscription_ids): + """ + Sets the delegation_subscription_ids of this DelegationControl. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :param delegation_subscription_ids: The delegation_subscription_ids of this DelegationControl. + :type: list[str] + """ + self._delegation_subscription_ids = delegation_subscription_ids + + @property + def is_auto_approve_during_maintenance(self): + """ + Gets the is_auto_approve_during_maintenance of this DelegationControl. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :return: The is_auto_approve_during_maintenance of this DelegationControl. + :rtype: bool + """ + return self._is_auto_approve_during_maintenance + + @is_auto_approve_during_maintenance.setter + def is_auto_approve_during_maintenance(self, is_auto_approve_during_maintenance): + """ + Sets the is_auto_approve_during_maintenance of this DelegationControl. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :param is_auto_approve_during_maintenance: The is_auto_approve_during_maintenance of this DelegationControl. + :type: bool + """ + self._is_auto_approve_during_maintenance = is_auto_approve_during_maintenance + + @property + def resource_ids(self): + """ + Gets the resource_ids of this DelegationControl. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :return: The resource_ids of this DelegationControl. + :rtype: list[str] + """ + return self._resource_ids + + @resource_ids.setter + def resource_ids(self, resource_ids): + """ + Sets the resource_ids of this DelegationControl. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :param resource_ids: The resource_ids of this DelegationControl. + :type: list[str] + """ + self._resource_ids = resource_ids + + @property + def resource_type(self): + """ + **[Required]** Gets the resource_type of this DelegationControl. + Resource type for which the Delegation Control is applicable to. + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this DelegationControl. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this DelegationControl. + Resource type for which the Delegation Control is applicable to. + + + :param resource_type: The resource_type of this DelegationControl. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def notification_topic_id(self): + """ + Gets the notification_topic_id of this DelegationControl. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :return: The notification_topic_id of this DelegationControl. + :rtype: str + """ + return self._notification_topic_id + + @notification_topic_id.setter + def notification_topic_id(self, notification_topic_id): + """ + Sets the notification_topic_id of this DelegationControl. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :param notification_topic_id: The notification_topic_id of this DelegationControl. + :type: str + """ + self._notification_topic_id = notification_topic_id + + @property + def notification_message_format(self): + """ + Gets the notification_message_format of this DelegationControl. + The format of the OCI Notification messages for this Delegation Control. + + Allowed values for this property are: "JSON", "HTML", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The notification_message_format of this DelegationControl. + :rtype: str + """ + return self._notification_message_format + + @notification_message_format.setter + def notification_message_format(self, notification_message_format): + """ + Sets the notification_message_format of this DelegationControl. + The format of the OCI Notification messages for this Delegation Control. + + + :param notification_message_format: The notification_message_format of this DelegationControl. + :type: str + """ + allowed_values = ["JSON", "HTML"] + if not value_allowed_none_or_none_sentinel(notification_message_format, allowed_values): + notification_message_format = 'UNKNOWN_ENUM_VALUE' + self._notification_message_format = notification_message_format + + @property + def vault_id(self): + """ + Gets the vault_id of this DelegationControl. + The OCID of the OCI Vault that will store the secrets containing the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. Delegate Access Control Service will generate the SSH keys and store them as secrets in the OCI Vault. + + + :return: The vault_id of this DelegationControl. + :rtype: str + """ + return self._vault_id + + @vault_id.setter + def vault_id(self, vault_id): + """ + Sets the vault_id of this DelegationControl. + The OCID of the OCI Vault that will store the secrets containing the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. Delegate Access Control Service will generate the SSH keys and store them as secrets in the OCI Vault. + + + :param vault_id: The vault_id of this DelegationControl. + :type: str + """ + self._vault_id = vault_id + + @property + def vault_key_id(self): + """ + Gets the vault_key_id of this DelegationControl. + The OCID of the Master Encryption Key in the OCI Vault specified by vaultId. This key will be used to encrypt the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. + + + :return: The vault_key_id of this DelegationControl. + :rtype: str + """ + return self._vault_key_id + + @vault_key_id.setter + def vault_key_id(self, vault_key_id): + """ + Sets the vault_key_id of this DelegationControl. + The OCID of the Master Encryption Key in the OCI Vault specified by vaultId. This key will be used to encrypt the SSH keys to access the resource governed by this Delegation Control by Delegate Access Control Service. This property is required when resourceType is CLOUDVMCLUSTER. + + + :param vault_key_id: The vault_key_id of this DelegationControl. + :type: str + """ + self._vault_key_id = vault_key_id + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegationControl. + The current lifecycle state of the Delegation Control. + + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this DelegationControl. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegationControl. + The current lifecycle state of the Delegation Control. + + + :param lifecycle_state: The lifecycle_state of this DelegationControl. + :type: str + """ + allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", "NEEDS_ATTENTION"] + 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_state_details(self): + """ + Gets the lifecycle_state_details of this DelegationControl. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegationControl. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegationControl. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegationControl. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def time_created(self): + """ + Gets the time_created of this DelegationControl. + Time when the Delegation Control was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegationControl. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegationControl. + Time when the Delegation Control was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegationControl. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegationControl. + Time when the Delegation Control was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegationControl. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegationControl. + Time when the Delegation Control was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegationControl. + :type: datetime + """ + self._time_updated = time_updated + + @property + def time_deleted(self): + """ + Gets the time_deleted of this DelegationControl. + Time when the Delegation Control was deleted expressed in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + Note a deleted Delegation Control still stays in the system, so that you can still audit Service Provider Actions associated with Delegated Resource Access Requests + raised on target resources governed by the deleted Delegation Control. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_deleted of this DelegationControl. + :rtype: datetime + """ + return self._time_deleted + + @time_deleted.setter + def time_deleted(self, time_deleted): + """ + Sets the time_deleted of this DelegationControl. + Time when the Delegation Control was deleted expressed in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + Note a deleted Delegation Control still stays in the system, so that you can still audit Service Provider Actions associated with Delegated Resource Access Requests + raised on target resources governed by the deleted Delegation Control. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_deleted: The time_deleted of this DelegationControl. + :type: datetime + """ + self._time_deleted = time_deleted + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegationControl. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegationControl. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegationControl. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegationControl. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegationControl. + 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 DelegationControl. + :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 DelegationControl. + 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 DelegationControl. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegationControl. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegationControl. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegationControl. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegationControl. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegation_control_resource_collection.py b/src/oci/delegate_access_control/models/delegation_control_resource_collection.py new file mode 100644 index 0000000000..273b62550d --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_control_resource_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationControlResourceCollection(object): + """ + List of DelegationControlResourceSummary objects. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DelegationControlResourceCollection 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 DelegationControlResourceCollection. + :type items: list[oci.delegate_access_control.models.DelegationControlResourceSummary] + + """ + self.swagger_types = { + 'items': 'list[DelegationControlResourceSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this DelegationControlResourceCollection. + List of DelegationControlResourceSummary objects. + + + :return: The items of this DelegationControlResourceCollection. + :rtype: list[oci.delegate_access_control.models.DelegationControlResourceSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this DelegationControlResourceCollection. + List of DelegationControlResourceSummary objects. + + + :param items: The items of this DelegationControlResourceCollection. + :type: list[oci.delegate_access_control.models.DelegationControlResourceSummary] + """ + 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/delegate_access_control/models/delegation_control_resource_summary.py b/src/oci/delegate_access_control/models/delegation_control_resource_summary.py new file mode 100644 index 0000000000..e2b25bd6c6 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_control_resource_summary.py @@ -0,0 +1,147 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationControlResourceSummary(object): + """ + Details of the resources that this Delegation Control is applicable to. + """ + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "CREATED" + RESOURCE_STATUS_CREATED = "CREATED" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "APPLYING" + RESOURCE_STATUS_APPLYING = "APPLYING" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "APPLIED" + RESOURCE_STATUS_APPLIED = "APPLIED" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "APPLY_FAILED" + RESOURCE_STATUS_APPLY_FAILED = "APPLY_FAILED" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "UPDATING" + RESOURCE_STATUS_UPDATING = "UPDATING" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "UPDATE_FAILED" + RESOURCE_STATUS_UPDATE_FAILED = "UPDATE_FAILED" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "DELETING" + RESOURCE_STATUS_DELETING = "DELETING" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "DELETED" + RESOURCE_STATUS_DELETED = "DELETED" + + #: A constant which can be used with the resource_status property of a DelegationControlResourceSummary. + #: This constant has a value of "DELETION_FAILED" + RESOURCE_STATUS_DELETION_FAILED = "DELETION_FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new DelegationControlResourceSummary 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 DelegationControlResourceSummary. + :type id: str + + :param resource_status: + The value to assign to the resource_status property of this DelegationControlResourceSummary. + Allowed values for this property are: "CREATED", "APPLYING", "APPLIED", "APPLY_FAILED", "UPDATING", "UPDATE_FAILED", "DELETING", "DELETED", "DELETION_FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_status: str + + """ + self.swagger_types = { + 'id': 'str', + 'resource_status': 'str' + } + + self.attribute_map = { + 'id': 'id', + 'resource_status': 'resourceStatus' + } + + self._id = None + self._resource_status = None + + @property + def id(self): + """ + Gets the id of this DelegationControlResourceSummary. + OCID of the resource. + + + :return: The id of this DelegationControlResourceSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegationControlResourceSummary. + OCID of the resource. + + + :param id: The id of this DelegationControlResourceSummary. + :type: str + """ + self._id = id + + @property + def resource_status(self): + """ + Gets the resource_status of this DelegationControlResourceSummary. + The current status of the resource in Delegation Control. + + Allowed values for this property are: "CREATED", "APPLYING", "APPLIED", "APPLY_FAILED", "UPDATING", "UPDATE_FAILED", "DELETING", "DELETED", "DELETION_FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_status of this DelegationControlResourceSummary. + :rtype: str + """ + return self._resource_status + + @resource_status.setter + def resource_status(self, resource_status): + """ + Sets the resource_status of this DelegationControlResourceSummary. + The current status of the resource in Delegation Control. + + + :param resource_status: The resource_status of this DelegationControlResourceSummary. + :type: str + """ + allowed_values = ["CREATED", "APPLYING", "APPLIED", "APPLY_FAILED", "UPDATING", "UPDATE_FAILED", "DELETING", "DELETED", "DELETION_FAILED"] + if not value_allowed_none_or_none_sentinel(resource_status, allowed_values): + resource_status = 'UNKNOWN_ENUM_VALUE' + self._resource_status = resource_status + + 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/delegate_access_control/models/delegation_control_summary.py b/src/oci/delegate_access_control/models/delegation_control_summary.py new file mode 100644 index 0000000000..5641db3dc1 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_control_summary.py @@ -0,0 +1,465 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationControlSummary(object): + """ + Summary of the Delegation Control. + """ + + #: A constant which can be used with the resource_type property of a DelegationControlSummary. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a DelegationControlSummary. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + def __init__(self, **kwargs): + """ + Initializes a new DelegationControlSummary 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 DelegationControlSummary. + :type id: str + + :param display_name: + The value to assign to the display_name property of this DelegationControlSummary. + :type display_name: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegationControlSummary. + :type compartment_id: str + + :param resource_type: + The value to assign to the resource_type property of this DelegationControlSummary. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param time_created: + The value to assign to the time_created property of this DelegationControlSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegationControlSummary. + :type time_updated: datetime + + :param time_deleted: + The value to assign to the time_deleted property of this DelegationControlSummary. + :type time_deleted: datetime + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegationControlSummary. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegationControlSummary. + :type lifecycle_state_details: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegationControlSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegationControlSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegationControlSummary. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'display_name': 'str', + 'compartment_id': 'str', + 'resource_type': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'time_deleted': 'datetime', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'display_name': 'displayName', + 'compartment_id': 'compartmentId', + 'resource_type': 'resourceType', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'time_deleted': 'timeDeleted', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._display_name = None + self._compartment_id = None + self._resource_type = None + self._time_created = None + self._time_updated = None + self._time_deleted = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegationControlSummary. + The OCID of the Delegation Control. + + + :return: The id of this DelegationControlSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegationControlSummary. + The OCID of the Delegation Control. + + + :param id: The id of this DelegationControlSummary. + :type: str + """ + self._id = id + + @property + def display_name(self): + """ + **[Required]** Gets the display_name of this DelegationControlSummary. + Name of the Delegation Control. The name does not need to be unique. + + + :return: The display_name of this DelegationControlSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegationControlSummary. + Name of the Delegation Control. The name does not need to be unique. + + + :param display_name: The display_name of this DelegationControlSummary. + :type: str + """ + self._display_name = display_name + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this DelegationControlSummary. + The OCID of the compartment that contains the Delegation Control. + + + :return: The compartment_id of this DelegationControlSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegationControlSummary. + The OCID of the compartment that contains the Delegation Control. + + + :param compartment_id: The compartment_id of this DelegationControlSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def resource_type(self): + """ + **[Required]** Gets the resource_type of this DelegationControlSummary. + resourceType for which the Delegation Control is applicable + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this DelegationControlSummary. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this DelegationControlSummary. + resourceType for which the Delegation Control is applicable + + + :param resource_type: The resource_type of this DelegationControlSummary. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def time_created(self): + """ + Gets the time_created of this DelegationControlSummary. + Time when the Delegation Control was created, expressed in `RFC 3339]`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegationControlSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegationControlSummary. + Time when the Delegation Control was created, expressed in `RFC 3339]`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegationControlSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegationControlSummary. + Time when the Delegation Control was last modified, expressed in `RFC 3339]`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegationControlSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegationControlSummary. + Time when the Delegation Control was last modified, expressed in `RFC 3339]`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegationControlSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def time_deleted(self): + """ + Gets the time_deleted of this DelegationControlSummary. + Time when the Delegation Control was deleted, expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_deleted of this DelegationControlSummary. + :rtype: datetime + """ + return self._time_deleted + + @time_deleted.setter + def time_deleted(self, time_deleted): + """ + Sets the time_deleted of this DelegationControlSummary. + Time when the Delegation Control was deleted, expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_deleted: The time_deleted of this DelegationControlSummary. + :type: datetime + """ + self._time_deleted = time_deleted + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegationControlSummary. + The current lifecycle state of the Delegation Control. + + + :return: The lifecycle_state of this DelegationControlSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegationControlSummary. + The current lifecycle state of the Delegation Control. + + + :param lifecycle_state: The lifecycle_state of this DelegationControlSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_state_details(self): + """ + Gets the lifecycle_state_details of this DelegationControlSummary. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegationControlSummary. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegationControlSummary. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegationControlSummary. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegationControlSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegationControlSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegationControlSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegationControlSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegationControlSummary. + 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 DelegationControlSummary. + :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 DelegationControlSummary. + 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 DelegationControlSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegationControlSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegationControlSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegationControlSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegationControlSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegation_control_summary_collection.py b/src/oci/delegate_access_control/models/delegation_control_summary_collection.py new file mode 100644 index 0000000000..c28f6456a1 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_control_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationControlSummaryCollection(object): + """ + Results of Delegation Control search, which contains summary of the Delegation Control. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DelegationControlSummaryCollection 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 DelegationControlSummaryCollection. + :type items: list[oci.delegate_access_control.models.DelegationControlSummary] + + """ + self.swagger_types = { + 'items': 'list[DelegationControlSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this DelegationControlSummaryCollection. + contains DelegationControlSummary + + + :return: The items of this DelegationControlSummaryCollection. + :rtype: list[oci.delegate_access_control.models.DelegationControlSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this DelegationControlSummaryCollection. + contains DelegationControlSummary + + + :param items: The items of this DelegationControlSummaryCollection. + :type: list[oci.delegate_access_control.models.DelegationControlSummary] + """ + 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/delegate_access_control/models/delegation_subscription.py b/src/oci/delegate_access_control/models/delegation_subscription.py new file mode 100644 index 0000000000..6a52120b36 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_subscription.py @@ -0,0 +1,524 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationSubscription(object): + """ + Details of the Delegation Subscription. + """ + + #: A constant which can be used with the subscribed_service_type property of a DelegationSubscription. + #: This constant has a value of "TROUBLESHOOTING" + SUBSCRIBED_SERVICE_TYPE_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the subscribed_service_type property of a DelegationSubscription. + #: This constant has a value of "ASSISTED_PATCHING" + SUBSCRIBED_SERVICE_TYPE_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a DelegationSubscription. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new DelegationSubscription 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 DelegationSubscription. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegationSubscription. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this DelegationSubscription. + :type display_name: str + + :param service_provider_id: + The value to assign to the service_provider_id property of this DelegationSubscription. + :type service_provider_id: str + + :param description: + The value to assign to the description property of this DelegationSubscription. + :type description: str + + :param subscribed_service_type: + The value to assign to the subscribed_service_type property of this DelegationSubscription. + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type subscribed_service_type: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegationSubscription. + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegationSubscription. + :type lifecycle_state_details: str + + :param time_created: + The value to assign to the time_created property of this DelegationSubscription. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegationSubscription. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegationSubscription. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegationSubscription. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegationSubscription. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'service_provider_id': 'str', + 'description': 'str', + 'subscribed_service_type': 'str', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'service_provider_id': 'serviceProviderId', + 'description': 'description', + 'subscribed_service_type': 'subscribedServiceType', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._service_provider_id = None + self._description = None + self._subscribed_service_type = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegationSubscription. + Unique identifier for the Delegation Subscription. + + + :return: The id of this DelegationSubscription. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegationSubscription. + Unique identifier for the Delegation Subscription. + + + :param id: The id of this DelegationSubscription. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this DelegationSubscription. + The OCID of the compartment that contains the Delegation Subscription. + + + :return: The compartment_id of this DelegationSubscription. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegationSubscription. + The OCID of the compartment that contains the Delegation Subscription. + + + :param compartment_id: The compartment_id of this DelegationSubscription. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this DelegationSubscription. + Display name + + + :return: The display_name of this DelegationSubscription. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegationSubscription. + Display name + + + :param display_name: The display_name of this DelegationSubscription. + :type: str + """ + self._display_name = display_name + + @property + def service_provider_id(self): + """ + **[Required]** Gets the service_provider_id of this DelegationSubscription. + Unique identifier of the Service Provider. + + + :return: The service_provider_id of this DelegationSubscription. + :rtype: str + """ + return self._service_provider_id + + @service_provider_id.setter + def service_provider_id(self, service_provider_id): + """ + Sets the service_provider_id of this DelegationSubscription. + Unique identifier of the Service Provider. + + + :param service_provider_id: The service_provider_id of this DelegationSubscription. + :type: str + """ + self._service_provider_id = service_provider_id + + @property + def description(self): + """ + Gets the description of this DelegationSubscription. + Description of the Delegation Subscription. + + + :return: The description of this DelegationSubscription. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this DelegationSubscription. + Description of the Delegation Subscription. + + + :param description: The description of this DelegationSubscription. + :type: str + """ + self._description = description + + @property + def subscribed_service_type(self): + """ + **[Required]** Gets the subscribed_service_type of this DelegationSubscription. + Subscribed Service Provider Service Type. + + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The subscribed_service_type of this DelegationSubscription. + :rtype: str + """ + return self._subscribed_service_type + + @subscribed_service_type.setter + def subscribed_service_type(self, subscribed_service_type): + """ + Sets the subscribed_service_type of this DelegationSubscription. + Subscribed Service Provider Service Type. + + + :param subscribed_service_type: The subscribed_service_type of this DelegationSubscription. + :type: str + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if not value_allowed_none_or_none_sentinel(subscribed_service_type, allowed_values): + subscribed_service_type = 'UNKNOWN_ENUM_VALUE' + self._subscribed_service_type = subscribed_service_type + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegationSubscription. + The current lifecycle state of the Service Provider. + + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this DelegationSubscription. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegationSubscription. + The current lifecycle state of the Service Provider. + + + :param lifecycle_state: The lifecycle_state of this DelegationSubscription. + :type: str + """ + allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "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_state_details(self): + """ + Gets the lifecycle_state_details of this DelegationSubscription. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegationSubscription. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegationSubscription. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegationSubscription. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def time_created(self): + """ + Gets the time_created of this DelegationSubscription. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegationSubscription. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegationSubscription. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegationSubscription. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegationSubscription. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegationSubscription. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegationSubscription. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegationSubscription. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegationSubscription. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegationSubscription. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegationSubscription. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegationSubscription. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegationSubscription. + 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 DelegationSubscription. + :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 DelegationSubscription. + 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 DelegationSubscription. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegationSubscription. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegationSubscription. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegationSubscription. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegationSubscription. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegation_subscription_summary.py b/src/oci/delegate_access_control/models/delegation_subscription_summary.py new file mode 100644 index 0000000000..9ee46679fc --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_subscription_summary.py @@ -0,0 +1,461 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationSubscriptionSummary(object): + """ + Summary of the Delegation Subscription. + """ + + #: A constant which can be used with the subscribed_service_type property of a DelegationSubscriptionSummary. + #: This constant has a value of "TROUBLESHOOTING" + SUBSCRIBED_SERVICE_TYPE_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the subscribed_service_type property of a DelegationSubscriptionSummary. + #: This constant has a value of "ASSISTED_PATCHING" + SUBSCRIBED_SERVICE_TYPE_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + def __init__(self, **kwargs): + """ + Initializes a new DelegationSubscriptionSummary 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 DelegationSubscriptionSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this DelegationSubscriptionSummary. + :type compartment_id: str + + :param display_name: + The value to assign to the display_name property of this DelegationSubscriptionSummary. + :type display_name: str + + :param service_provider_id: + The value to assign to the service_provider_id property of this DelegationSubscriptionSummary. + :type service_provider_id: str + + :param subscribed_service_type: + The value to assign to the subscribed_service_type property of this DelegationSubscriptionSummary. + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type subscribed_service_type: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this DelegationSubscriptionSummary. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this DelegationSubscriptionSummary. + :type lifecycle_state_details: str + + :param time_created: + The value to assign to the time_created property of this DelegationSubscriptionSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this DelegationSubscriptionSummary. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this DelegationSubscriptionSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this DelegationSubscriptionSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this DelegationSubscriptionSummary. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'display_name': 'str', + 'service_provider_id': 'str', + 'subscribed_service_type': 'str', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'display_name': 'displayName', + 'service_provider_id': 'serviceProviderId', + 'subscribed_service_type': 'subscribedServiceType', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._display_name = None + self._service_provider_id = None + self._subscribed_service_type = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this DelegationSubscriptionSummary. + Unique identifier for the Delegation Subscription. + + + :return: The id of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this DelegationSubscriptionSummary. + Unique identifier for the Delegation Subscription. + + + :param id: The id of this DelegationSubscriptionSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this DelegationSubscriptionSummary. + The OCID of the compartment that contains the Delegation Subscription. + + + :return: The compartment_id of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this DelegationSubscriptionSummary. + The OCID of the compartment that contains the Delegation Subscription. + + + :param compartment_id: The compartment_id of this DelegationSubscriptionSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def display_name(self): + """ + Gets the display_name of this DelegationSubscriptionSummary. + Display name + + + :return: The display_name of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this DelegationSubscriptionSummary. + Display name + + + :param display_name: The display_name of this DelegationSubscriptionSummary. + :type: str + """ + self._display_name = display_name + + @property + def service_provider_id(self): + """ + **[Required]** Gets the service_provider_id of this DelegationSubscriptionSummary. + Unique identifier of the Service Provider. + + + :return: The service_provider_id of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._service_provider_id + + @service_provider_id.setter + def service_provider_id(self, service_provider_id): + """ + Sets the service_provider_id of this DelegationSubscriptionSummary. + Unique identifier of the Service Provider. + + + :param service_provider_id: The service_provider_id of this DelegationSubscriptionSummary. + :type: str + """ + self._service_provider_id = service_provider_id + + @property + def subscribed_service_type(self): + """ + **[Required]** Gets the subscribed_service_type of this DelegationSubscriptionSummary. + Subscribed Service Provider Service Type. + + Allowed values for this property are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The subscribed_service_type of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._subscribed_service_type + + @subscribed_service_type.setter + def subscribed_service_type(self, subscribed_service_type): + """ + Sets the subscribed_service_type of this DelegationSubscriptionSummary. + Subscribed Service Provider Service Type. + + + :param subscribed_service_type: The subscribed_service_type of this DelegationSubscriptionSummary. + :type: str + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if not value_allowed_none_or_none_sentinel(subscribed_service_type, allowed_values): + subscribed_service_type = 'UNKNOWN_ENUM_VALUE' + self._subscribed_service_type = subscribed_service_type + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this DelegationSubscriptionSummary. + The current lifecycle state of the Service Provider. + + + :return: The lifecycle_state of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this DelegationSubscriptionSummary. + The current lifecycle state of the Service Provider. + + + :param lifecycle_state: The lifecycle_state of this DelegationSubscriptionSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_state_details(self): + """ + Gets the lifecycle_state_details of this DelegationSubscriptionSummary. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this DelegationSubscriptionSummary. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this DelegationSubscriptionSummary. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this DelegationSubscriptionSummary. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def time_created(self): + """ + Gets the time_created of this DelegationSubscriptionSummary. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this DelegationSubscriptionSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this DelegationSubscriptionSummary. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this DelegationSubscriptionSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this DelegationSubscriptionSummary. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this DelegationSubscriptionSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this DelegationSubscriptionSummary. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this DelegationSubscriptionSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this DelegationSubscriptionSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this DelegationSubscriptionSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this DelegationSubscriptionSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this DelegationSubscriptionSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this DelegationSubscriptionSummary. + 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 DelegationSubscriptionSummary. + :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 DelegationSubscriptionSummary. + 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 DelegationSubscriptionSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this DelegationSubscriptionSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this DelegationSubscriptionSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this DelegationSubscriptionSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this DelegationSubscriptionSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/delegation_subscription_summary_collection.py b/src/oci/delegate_access_control/models/delegation_subscription_summary_collection.py new file mode 100644 index 0000000000..39c59824c0 --- /dev/null +++ b/src/oci/delegate_access_control/models/delegation_subscription_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 DelegationSubscriptionSummaryCollection(object): + """ + List of DelegationSubscriptionSummary objects. + """ + + def __init__(self, **kwargs): + """ + Initializes a new DelegationSubscriptionSummaryCollection 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 DelegationSubscriptionSummaryCollection. + :type items: list[oci.delegate_access_control.models.DelegationSubscriptionSummary] + + """ + self.swagger_types = { + 'items': 'list[DelegationSubscriptionSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this DelegationSubscriptionSummaryCollection. + List of DelegationSubscriptionSummary objects. + + + :return: The items of this DelegationSubscriptionSummaryCollection. + :rtype: list[oci.delegate_access_control.models.DelegationSubscriptionSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this DelegationSubscriptionSummaryCollection. + List of DelegationSubscriptionSummary objects. + + + :param items: The items of this DelegationSubscriptionSummaryCollection. + :type: list[oci.delegate_access_control.models.DelegationSubscriptionSummary] + """ + 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/delegate_access_control/models/reject_delegated_resource_access_request_details.py b/src/oci/delegate_access_control/models/reject_delegated_resource_access_request_details.py new file mode 100644 index 0000000000..32cca80e9b --- /dev/null +++ b/src/oci/delegate_access_control/models/reject_delegated_resource_access_request_details.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 RejectDelegatedResourceAccessRequestDetails(object): + """ + Summary of why the Delegated Resource Access Request was rejected. + """ + + def __init__(self, **kwargs): + """ + Initializes a new RejectDelegatedResourceAccessRequestDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param approver_comment: + The value to assign to the approver_comment property of this RejectDelegatedResourceAccessRequestDetails. + :type approver_comment: str + + """ + self.swagger_types = { + 'approver_comment': 'str' + } + + self.attribute_map = { + 'approver_comment': 'approverComment' + } + + self._approver_comment = None + + @property + def approver_comment(self): + """ + Gets the approver_comment of this RejectDelegatedResourceAccessRequestDetails. + Comment by the approver explaining why the request is rejected. + + + :return: The approver_comment of this RejectDelegatedResourceAccessRequestDetails. + :rtype: str + """ + return self._approver_comment + + @approver_comment.setter + def approver_comment(self, approver_comment): + """ + Sets the approver_comment of this RejectDelegatedResourceAccessRequestDetails. + Comment by the approver explaining why the request is rejected. + + + :param approver_comment: The approver_comment of this RejectDelegatedResourceAccessRequestDetails. + :type: str + """ + self._approver_comment = approver_comment + + 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/delegate_access_control/models/revoke_delegated_resource_access_request_details.py b/src/oci/delegate_access_control/models/revoke_delegated_resource_access_request_details.py new file mode 100644 index 0000000000..c098885c97 --- /dev/null +++ b/src/oci/delegate_access_control/models/revoke_delegated_resource_access_request_details.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 RevokeDelegatedResourceAccessRequestDetails(object): + """ + Summary of why the already approved Delegated Resource Access Request was revoked. + """ + + def __init__(self, **kwargs): + """ + Initializes a new RevokeDelegatedResourceAccessRequestDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param approver_comment: + The value to assign to the approver_comment property of this RevokeDelegatedResourceAccessRequestDetails. + :type approver_comment: str + + """ + self.swagger_types = { + 'approver_comment': 'str' + } + + self.attribute_map = { + 'approver_comment': 'approverComment' + } + + self._approver_comment = None + + @property + def approver_comment(self): + """ + Gets the approver_comment of this RevokeDelegatedResourceAccessRequestDetails. + Comment specified by the approver explaining why the approval is revoked. + + + :return: The approver_comment of this RevokeDelegatedResourceAccessRequestDetails. + :rtype: str + """ + return self._approver_comment + + @approver_comment.setter + def approver_comment(self, approver_comment): + """ + Sets the approver_comment of this RevokeDelegatedResourceAccessRequestDetails. + Comment specified by the approver explaining why the approval is revoked. + + + :param approver_comment: The approver_comment of this RevokeDelegatedResourceAccessRequestDetails. + :type: str + """ + self._approver_comment = approver_comment + + 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/delegate_access_control/models/service_provider.py b/src/oci/delegate_access_control/models/service_provider.py new file mode 100644 index 0000000000..643dc96212 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider.py @@ -0,0 +1,583 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProvider(object): + """ + Details of the Service Provider. Service provider offers services to the customer to support the delegated resources. + """ + + #: A constant which can be used with the service_provider_type property of a ServiceProvider. + #: This constant has a value of "ORACLE_PROVIDED" + SERVICE_PROVIDER_TYPE_ORACLE_PROVIDED = "ORACLE_PROVIDED" + + #: A constant which can be used with the service_types property of a ServiceProvider. + #: This constant has a value of "TROUBLESHOOTING" + SERVICE_TYPES_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the service_types property of a ServiceProvider. + #: This constant has a value of "ASSISTED_PATCHING" + SERVICE_TYPES_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + #: A constant which can be used with the supported_resource_types property of a ServiceProvider. + #: This constant has a value of "VMCLUSTER" + SUPPORTED_RESOURCE_TYPES_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the supported_resource_types property of a ServiceProvider. + #: This constant has a value of "CLOUDVMCLUSTER" + SUPPORTED_RESOURCE_TYPES_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a ServiceProvider. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProvider 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 ServiceProvider. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ServiceProvider. + :type compartment_id: str + + :param name: + The value to assign to the name property of this ServiceProvider. + :type name: str + + :param description: + The value to assign to the description property of this ServiceProvider. + :type description: str + + :param service_provider_type: + The value to assign to the service_provider_type property of this ServiceProvider. + Allowed values for this property are: "ORACLE_PROVIDED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_provider_type: str + + :param service_types: + The value to assign to the service_types property of this ServiceProvider. + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_types: list[str] + + :param supported_resource_types: + The value to assign to the supported_resource_types property of this ServiceProvider. + Allowed values for items in this list are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type supported_resource_types: list[str] + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ServiceProvider. + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this ServiceProvider. + :type lifecycle_state_details: str + + :param time_created: + The value to assign to the time_created property of this ServiceProvider. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ServiceProvider. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this ServiceProvider. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ServiceProvider. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this ServiceProvider. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'name': 'str', + 'description': 'str', + 'service_provider_type': 'str', + 'service_types': 'list[str]', + 'supported_resource_types': 'list[str]', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'name': 'name', + 'description': 'description', + 'service_provider_type': 'serviceProviderType', + 'service_types': 'serviceTypes', + 'supported_resource_types': 'supportedResourceTypes', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._name = None + self._description = None + self._service_provider_type = None + self._service_types = None + self._supported_resource_types = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ServiceProvider. + Unique identifier for the Service Provider. + + + :return: The id of this ServiceProvider. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ServiceProvider. + Unique identifier for the Service Provider. + + + :param id: The id of this ServiceProvider. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this ServiceProvider. + The OCID of the compartment that contains the Delegation Control. + + + :return: The compartment_id of this ServiceProvider. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ServiceProvider. + The OCID of the compartment that contains the Delegation Control. + + + :param compartment_id: The compartment_id of this ServiceProvider. + :type: str + """ + self._compartment_id = compartment_id + + @property + def name(self): + """ + **[Required]** Gets the name of this ServiceProvider. + Unique name of the Service Provider. + + + :return: The name of this ServiceProvider. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this ServiceProvider. + Unique name of the Service Provider. + + + :param name: The name of this ServiceProvider. + :type: str + """ + self._name = name + + @property + def description(self): + """ + Gets the description of this ServiceProvider. + Description of the Service Provider. + + + :return: The description of this ServiceProvider. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ServiceProvider. + Description of the Service Provider. + + + :param description: The description of this ServiceProvider. + :type: str + """ + self._description = description + + @property + def service_provider_type(self): + """ + **[Required]** Gets the service_provider_type of this ServiceProvider. + Service Provider type. + + Allowed values for this property are: "ORACLE_PROVIDED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_provider_type of this ServiceProvider. + :rtype: str + """ + return self._service_provider_type + + @service_provider_type.setter + def service_provider_type(self, service_provider_type): + """ + Sets the service_provider_type of this ServiceProvider. + Service Provider type. + + + :param service_provider_type: The service_provider_type of this ServiceProvider. + :type: str + """ + allowed_values = ["ORACLE_PROVIDED"] + if not value_allowed_none_or_none_sentinel(service_provider_type, allowed_values): + service_provider_type = 'UNKNOWN_ENUM_VALUE' + self._service_provider_type = service_provider_type + + @property + def service_types(self): + """ + **[Required]** Gets the service_types of this ServiceProvider. + Types of services offered by this provider. + + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_types of this ServiceProvider. + :rtype: list[str] + """ + return self._service_types + + @service_types.setter + def service_types(self, service_types): + """ + Sets the service_types of this ServiceProvider. + Types of services offered by this provider. + + + :param service_types: The service_types of this ServiceProvider. + :type: list[str] + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if service_types: + service_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in service_types] + self._service_types = service_types + + @property + def supported_resource_types(self): + """ + **[Required]** Gets the supported_resource_types of this ServiceProvider. + Resource types for which this provider will provide service. Default to all if not specified. + + Allowed values for items in this list are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The supported_resource_types of this ServiceProvider. + :rtype: list[str] + """ + return self._supported_resource_types + + @supported_resource_types.setter + def supported_resource_types(self, supported_resource_types): + """ + Sets the supported_resource_types of this ServiceProvider. + Resource types for which this provider will provide service. Default to all if not specified. + + + :param supported_resource_types: The supported_resource_types of this ServiceProvider. + :type: list[str] + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if supported_resource_types: + supported_resource_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in supported_resource_types] + self._supported_resource_types = supported_resource_types + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this ServiceProvider. + The current lifecycle state of the Service Provider. + + Allowed values for this property are: "CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ServiceProvider. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ServiceProvider. + The current lifecycle state of the Service Provider. + + + :param lifecycle_state: The lifecycle_state of this ServiceProvider. + :type: str + """ + allowed_values = ["CREATING", "ACTIVE", "UPDATING", "DELETING", "DELETED", "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_state_details(self): + """ + Gets the lifecycle_state_details of this ServiceProvider. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this ServiceProvider. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this ServiceProvider. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this ServiceProvider. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def time_created(self): + """ + Gets the time_created of this ServiceProvider. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this ServiceProvider. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ServiceProvider. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this ServiceProvider. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ServiceProvider. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this ServiceProvider. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ServiceProvider. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this ServiceProvider. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ServiceProvider. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ServiceProvider. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ServiceProvider. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ServiceProvider. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ServiceProvider. + 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 ServiceProvider. + :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 ServiceProvider. + 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 ServiceProvider. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this ServiceProvider. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this ServiceProvider. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this ServiceProvider. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this ServiceProvider. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/service_provider_action.py b/src/oci/delegate_access_control/models/service_provider_action.py new file mode 100644 index 0000000000..5d279e5ca2 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_action.py @@ -0,0 +1,371 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderAction(object): + """ + Details of the Service Provider Action. Service provider actions are a pre-defined set of commands available to the support operator on different layers of the infrastructure. Although the groupings may differ depending on the infrastructure layers, + the groups are designed to enable the support operator access to commands to resolve a specific set of issues. + """ + + #: A constant which can be used with the resource_type property of a ServiceProviderAction. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a ServiceProviderAction. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the service_provider_service_types property of a ServiceProviderAction. + #: This constant has a value of "TROUBLESHOOTING" + SERVICE_PROVIDER_SERVICE_TYPES_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the service_provider_service_types property of a ServiceProviderAction. + #: This constant has a value of "ASSISTED_PATCHING" + SERVICE_PROVIDER_SERVICE_TYPES_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + #: A constant which can be used with the lifecycle_state property of a ServiceProviderAction. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a ServiceProviderAction. + #: This constant has a value of "INACTIVE" + LIFECYCLE_STATE_INACTIVE = "INACTIVE" + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderAction 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 ServiceProviderAction. + :type id: str + + :param name: + The value to assign to the name property of this ServiceProviderAction. + :type name: str + + :param customer_display_name: + The value to assign to the customer_display_name property of this ServiceProviderAction. + :type customer_display_name: str + + :param component: + The value to assign to the component property of this ServiceProviderAction. + :type component: str + + :param resource_type: + The value to assign to the resource_type property of this ServiceProviderAction. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param service_provider_service_types: + The value to assign to the service_provider_service_types property of this ServiceProviderAction. + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_provider_service_types: list[str] + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ServiceProviderAction. + Allowed values for this property are: "ACTIVE", "INACTIVE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param description: + The value to assign to the description property of this ServiceProviderAction. + :type description: str + + :param properties: + The value to assign to the properties property of this ServiceProviderAction. + :type properties: list[oci.delegate_access_control.models.ServiceProviderActionProperties] + + """ + self.swagger_types = { + 'id': 'str', + 'name': 'str', + 'customer_display_name': 'str', + 'component': 'str', + 'resource_type': 'str', + 'service_provider_service_types': 'list[str]', + 'lifecycle_state': 'str', + 'description': 'str', + 'properties': 'list[ServiceProviderActionProperties]' + } + + self.attribute_map = { + 'id': 'id', + 'name': 'name', + 'customer_display_name': 'customerDisplayName', + 'component': 'component', + 'resource_type': 'resourceType', + 'service_provider_service_types': 'serviceProviderServiceTypes', + 'lifecycle_state': 'lifecycleState', + 'description': 'description', + 'properties': 'properties' + } + + self._id = None + self._name = None + self._customer_display_name = None + self._component = None + self._resource_type = None + self._service_provider_service_types = None + self._lifecycle_state = None + self._description = None + self._properties = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ServiceProviderAction. + Unique Oracle assigned identifier for the Service Provider Action. + + + :return: The id of this ServiceProviderAction. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ServiceProviderAction. + Unique Oracle assigned identifier for the Service Provider Action. + + + :param id: The id of this ServiceProviderAction. + :type: str + """ + self._id = id + + @property + def name(self): + """ + **[Required]** Gets the name of this ServiceProviderAction. + Unique name of the Service Provider Action. + + + :return: The name of this ServiceProviderAction. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this ServiceProviderAction. + Unique name of the Service Provider Action. + + + :param name: The name of this ServiceProviderAction. + :type: str + """ + self._name = name + + @property + def customer_display_name(self): + """ + Gets the customer_display_name of this ServiceProviderAction. + Display Name of the Service Provider Action. + + + :return: The customer_display_name of this ServiceProviderAction. + :rtype: str + """ + return self._customer_display_name + + @customer_display_name.setter + def customer_display_name(self, customer_display_name): + """ + Sets the customer_display_name of this ServiceProviderAction. + Display Name of the Service Provider Action. + + + :param customer_display_name: The customer_display_name of this ServiceProviderAction. + :type: str + """ + self._customer_display_name = customer_display_name + + @property + def component(self): + """ + Gets the component of this ServiceProviderAction. + Name of the infrastructure layer associated with the Service Provider Action. + + + :return: The component of this ServiceProviderAction. + :rtype: str + """ + return self._component + + @component.setter + def component(self, component): + """ + Sets the component of this ServiceProviderAction. + Name of the infrastructure layer associated with the Service Provider Action. + + + :param component: The component of this ServiceProviderAction. + :type: str + """ + self._component = component + + @property + def resource_type(self): + """ + Gets the resource_type of this ServiceProviderAction. + resourceType for which the ServiceProviderAction is applicable + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this ServiceProviderAction. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this ServiceProviderAction. + resourceType for which the ServiceProviderAction is applicable + + + :param resource_type: The resource_type of this ServiceProviderAction. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def service_provider_service_types(self): + """ + Gets the service_provider_service_types of this ServiceProviderAction. + List of Service Provider Service Types that this Service Provider Action is applicable to. + + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_provider_service_types of this ServiceProviderAction. + :rtype: list[str] + """ + return self._service_provider_service_types + + @service_provider_service_types.setter + def service_provider_service_types(self, service_provider_service_types): + """ + Sets the service_provider_service_types of this ServiceProviderAction. + List of Service Provider Service Types that this Service Provider Action is applicable to. + + + :param service_provider_service_types: The service_provider_service_types of this ServiceProviderAction. + :type: list[str] + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if service_provider_service_types: + service_provider_service_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in service_provider_service_types] + self._service_provider_service_types = service_provider_service_types + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this ServiceProviderAction. + The current lifecycle state of the Service Provider Action. + + Allowed values for this property are: "ACTIVE", "INACTIVE", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this ServiceProviderAction. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ServiceProviderAction. + The current lifecycle state of the Service Provider Action. + + + :param lifecycle_state: The lifecycle_state of this ServiceProviderAction. + :type: str + """ + allowed_values = ["ACTIVE", "INACTIVE"] + if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): + lifecycle_state = 'UNKNOWN_ENUM_VALUE' + self._lifecycle_state = lifecycle_state + + @property + def description(self): + """ + Gets the description of this ServiceProviderAction. + Description of the Service Provider Action in terms of associated risk profile, and characteristics of the operating system commands made + available to the support operator under this Service Provider Action. + + + :return: The description of this ServiceProviderAction. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ServiceProviderAction. + Description of the Service Provider Action in terms of associated risk profile, and characteristics of the operating system commands made + available to the support operator under this Service Provider Action. + + + :param description: The description of this ServiceProviderAction. + :type: str + """ + self._description = description + + @property + def properties(self): + """ + Gets the properties of this ServiceProviderAction. + Fine grained properties associated with the Delegation Control. + + + :return: The properties of this ServiceProviderAction. + :rtype: list[oci.delegate_access_control.models.ServiceProviderActionProperties] + """ + return self._properties + + @properties.setter + def properties(self, properties): + """ + Sets the properties of this ServiceProviderAction. + Fine grained properties associated with the Delegation Control. + + + :param properties: The properties of this ServiceProviderAction. + :type: list[oci.delegate_access_control.models.ServiceProviderActionProperties] + """ + self._properties = properties + + 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/delegate_access_control/models/service_provider_action_properties.py b/src/oci/delegate_access_control/models/service_provider_action_properties.py new file mode 100644 index 0000000000..0dfec6ba91 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_action_properties.py @@ -0,0 +1,103 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderActionProperties(object): + """ + Details of the properties of Service Provider Action. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderActionProperties object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param name: + The value to assign to the name property of this ServiceProviderActionProperties. + :type name: str + + :param value: + The value to assign to the value property of this ServiceProviderActionProperties. + :type value: str + + """ + self.swagger_types = { + 'name': 'str', + 'value': 'str' + } + + self.attribute_map = { + 'name': 'name', + 'value': 'value' + } + + self._name = None + self._value = None + + @property + def name(self): + """ + Gets the name of this ServiceProviderActionProperties. + Name of the property + + + :return: The name of this ServiceProviderActionProperties. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this ServiceProviderActionProperties. + Name of the property + + + :param name: The name of this ServiceProviderActionProperties. + :type: str + """ + self._name = name + + @property + def value(self): + """ + Gets the value of this ServiceProviderActionProperties. + value of the property + + + :return: The value of this ServiceProviderActionProperties. + :rtype: str + """ + return self._value + + @value.setter + def value(self, value): + """ + Sets the value of this ServiceProviderActionProperties. + value of the property + + + :param value: The value of this ServiceProviderActionProperties. + :type: str + """ + self._value = value + + 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/delegate_access_control/models/service_provider_action_summary.py b/src/oci/delegate_access_control/models/service_provider_action_summary.py new file mode 100644 index 0000000000..de9f8f03af --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_action_summary.py @@ -0,0 +1,323 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderActionSummary(object): + """ + Details of the Service Provider Action. Service provider actions are pre-defined set of commands available to the support operator on different layers of the infrastructure. + """ + + #: A constant which can be used with the resource_type property of a ServiceProviderActionSummary. + #: This constant has a value of "VMCLUSTER" + RESOURCE_TYPE_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the resource_type property of a ServiceProviderActionSummary. + #: This constant has a value of "CLOUDVMCLUSTER" + RESOURCE_TYPE_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + #: A constant which can be used with the service_provider_service_types property of a ServiceProviderActionSummary. + #: This constant has a value of "TROUBLESHOOTING" + SERVICE_PROVIDER_SERVICE_TYPES_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the service_provider_service_types property of a ServiceProviderActionSummary. + #: This constant has a value of "ASSISTED_PATCHING" + SERVICE_PROVIDER_SERVICE_TYPES_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderActionSummary 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 ServiceProviderActionSummary. + :type id: str + + :param name: + The value to assign to the name property of this ServiceProviderActionSummary. + :type name: str + + :param customer_display_name: + The value to assign to the customer_display_name property of this ServiceProviderActionSummary. + :type customer_display_name: str + + :param component: + The value to assign to the component property of this ServiceProviderActionSummary. + :type component: str + + :param resource_type: + The value to assign to the resource_type property of this ServiceProviderActionSummary. + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type resource_type: str + + :param service_provider_service_types: + The value to assign to the service_provider_service_types property of this ServiceProviderActionSummary. + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_provider_service_types: list[str] + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ServiceProviderActionSummary. + :type lifecycle_state: str + + :param description: + The value to assign to the description property of this ServiceProviderActionSummary. + :type description: str + + """ + self.swagger_types = { + 'id': 'str', + 'name': 'str', + 'customer_display_name': 'str', + 'component': 'str', + 'resource_type': 'str', + 'service_provider_service_types': 'list[str]', + 'lifecycle_state': 'str', + 'description': 'str' + } + + self.attribute_map = { + 'id': 'id', + 'name': 'name', + 'customer_display_name': 'customerDisplayName', + 'component': 'component', + 'resource_type': 'resourceType', + 'service_provider_service_types': 'serviceProviderServiceTypes', + 'lifecycle_state': 'lifecycleState', + 'description': 'description' + } + + self._id = None + self._name = None + self._customer_display_name = None + self._component = None + self._resource_type = None + self._service_provider_service_types = None + self._lifecycle_state = None + self._description = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ServiceProviderActionSummary. + Unique identifier assigned by Oracle to a Service Provider Action. + + + :return: The id of this ServiceProviderActionSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ServiceProviderActionSummary. + Unique identifier assigned by Oracle to a Service Provider Action. + + + :param id: The id of this ServiceProviderActionSummary. + :type: str + """ + self._id = id + + @property + def name(self): + """ + **[Required]** Gets the name of this ServiceProviderActionSummary. + Name of the Service Provider Action. + + + :return: The name of this ServiceProviderActionSummary. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this ServiceProviderActionSummary. + Name of the Service Provider Action. + + + :param name: The name of this ServiceProviderActionSummary. + :type: str + """ + self._name = name + + @property + def customer_display_name(self): + """ + Gets the customer_display_name of this ServiceProviderActionSummary. + Display Name of the Service Provider Action. + + + :return: The customer_display_name of this ServiceProviderActionSummary. + :rtype: str + """ + return self._customer_display_name + + @customer_display_name.setter + def customer_display_name(self, customer_display_name): + """ + Sets the customer_display_name of this ServiceProviderActionSummary. + Display Name of the Service Provider Action. + + + :param customer_display_name: The customer_display_name of this ServiceProviderActionSummary. + :type: str + """ + self._customer_display_name = customer_display_name + + @property + def component(self): + """ + Gets the component of this ServiceProviderActionSummary. + Name of the component for which the Service Provider Action is applicable. + + + :return: The component of this ServiceProviderActionSummary. + :rtype: str + """ + return self._component + + @component.setter + def component(self, component): + """ + Sets the component of this ServiceProviderActionSummary. + Name of the component for which the Service Provider Action is applicable. + + + :param component: The component of this ServiceProviderActionSummary. + :type: str + """ + self._component = component + + @property + def resource_type(self): + """ + Gets the resource_type of this ServiceProviderActionSummary. + resourceType for which the ServiceProviderAction is applicable + + Allowed values for this property are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The resource_type of this ServiceProviderActionSummary. + :rtype: str + """ + return self._resource_type + + @resource_type.setter + def resource_type(self, resource_type): + """ + Sets the resource_type of this ServiceProviderActionSummary. + resourceType for which the ServiceProviderAction is applicable + + + :param resource_type: The resource_type of this ServiceProviderActionSummary. + :type: str + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if not value_allowed_none_or_none_sentinel(resource_type, allowed_values): + resource_type = 'UNKNOWN_ENUM_VALUE' + self._resource_type = resource_type + + @property + def service_provider_service_types(self): + """ + Gets the service_provider_service_types of this ServiceProviderActionSummary. + List of Service Provider Service Types that this Service Provider Action is applicable to. + + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_provider_service_types of this ServiceProviderActionSummary. + :rtype: list[str] + """ + return self._service_provider_service_types + + @service_provider_service_types.setter + def service_provider_service_types(self, service_provider_service_types): + """ + Sets the service_provider_service_types of this ServiceProviderActionSummary. + List of Service Provider Service Types that this Service Provider Action is applicable to. + + + :param service_provider_service_types: The service_provider_service_types of this ServiceProviderActionSummary. + :type: list[str] + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if service_provider_service_types: + service_provider_service_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in service_provider_service_types] + self._service_provider_service_types = service_provider_service_types + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this ServiceProviderActionSummary. + The current lifecycle state of the Service Provider Action. + + + :return: The lifecycle_state of this ServiceProviderActionSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ServiceProviderActionSummary. + The current lifecycle state of the Service Provider Action. + + + :param lifecycle_state: The lifecycle_state of this ServiceProviderActionSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def description(self): + """ + Gets the description of this ServiceProviderActionSummary. + Description of the Service Provider Action in terms of associated risk profile, and characteristics of the operating system commands made + available to the support operator under this Service Provider Action. + + + :return: The description of this ServiceProviderActionSummary. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this ServiceProviderActionSummary. + Description of the Service Provider Action in terms of associated risk profile, and characteristics of the operating system commands made + available to the support operator under this Service Provider Action. + + + :param description: The description of this ServiceProviderActionSummary. + :type: str + """ + self._description = description + + 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/delegate_access_control/models/service_provider_action_summary_collection.py b/src/oci/delegate_access_control/models/service_provider_action_summary_collection.py new file mode 100644 index 0000000000..a84c099b6e --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_action_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderActionSummaryCollection(object): + """ + List of ServiceProviderActionSummary resources. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderActionSummaryCollection 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 ServiceProviderActionSummaryCollection. + :type items: list[oci.delegate_access_control.models.ServiceProviderActionSummary] + + """ + self.swagger_types = { + 'items': 'list[ServiceProviderActionSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ServiceProviderActionSummaryCollection. + contains ServiceProviderActionSummary + + + :return: The items of this ServiceProviderActionSummaryCollection. + :rtype: list[oci.delegate_access_control.models.ServiceProviderActionSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ServiceProviderActionSummaryCollection. + contains ServiceProviderActionSummary + + + :param items: The items of this ServiceProviderActionSummaryCollection. + :type: list[oci.delegate_access_control.models.ServiceProviderActionSummary] + """ + 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/delegate_access_control/models/service_provider_interaction_collection.py b/src/oci/delegate_access_control/models/service_provider_interaction_collection.py new file mode 100644 index 0000000000..54c024f6ce --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_interaction_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderInteractionCollection(object): + """ + Results of access request additionalInfo search, which contains details of the conversation between customer and operator. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderInteractionCollection 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 ServiceProviderInteractionCollection. + :type items: list[oci.delegate_access_control.models.ServiceProviderInteractionSummary] + + """ + self.swagger_types = { + 'items': 'list[ServiceProviderInteractionSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ServiceProviderInteractionCollection. + contains ServiceProviderInteractionSummary + + + :return: The items of this ServiceProviderInteractionCollection. + :rtype: list[oci.delegate_access_control.models.ServiceProviderInteractionSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ServiceProviderInteractionCollection. + contains ServiceProviderInteractionSummary + + + :param items: The items of this ServiceProviderInteractionCollection. + :type: list[oci.delegate_access_control.models.ServiceProviderInteractionSummary] + """ + 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/delegate_access_control/models/service_provider_interaction_request_details.py b/src/oci/delegate_access_control/models/service_provider_interaction_request_details.py new file mode 100644 index 0000000000..faf8670777 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_interaction_request_details.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderInteractionRequestDetails(object): + """ + Details for asking operator to provide more information. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderInteractionRequestDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param more_info_details: + The value to assign to the more_info_details property of this ServiceProviderInteractionRequestDetails. + :type more_info_details: str + + """ + self.swagger_types = { + 'more_info_details': 'str' + } + + self.attribute_map = { + 'more_info_details': 'moreInfoDetails' + } + + self._more_info_details = None + + @property + def more_info_details(self): + """ + Gets the more_info_details of this ServiceProviderInteractionRequestDetails. + Questions for operator to provide more information. + + + :return: The more_info_details of this ServiceProviderInteractionRequestDetails. + :rtype: str + """ + return self._more_info_details + + @more_info_details.setter + def more_info_details(self, more_info_details): + """ + Sets the more_info_details of this ServiceProviderInteractionRequestDetails. + Questions for operator to provide more information. + + + :param more_info_details: The more_info_details of this ServiceProviderInteractionRequestDetails. + :type: str + """ + self._more_info_details = more_info_details + + 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/delegate_access_control/models/service_provider_interaction_summary.py b/src/oci/delegate_access_control/models/service_provider_interaction_summary.py new file mode 100644 index 0000000000..f7638051b3 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_interaction_summary.py @@ -0,0 +1,247 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderInteractionSummary(object): + """ + Summary of customer and operator conversation. + """ + + #: A constant which can be used with the user_type property of a ServiceProviderInteractionSummary. + #: This constant has a value of "CUSTOMER" + USER_TYPE_CUSTOMER = "CUSTOMER" + + #: A constant which can be used with the user_type property of a ServiceProviderInteractionSummary. + #: This constant has a value of "OPERATOR" + USER_TYPE_OPERATOR = "OPERATOR" + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderInteractionSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param message_identifier: + The value to assign to the message_identifier property of this ServiceProviderInteractionSummary. + :type message_identifier: str + + :param user_id: + The value to assign to the user_id property of this ServiceProviderInteractionSummary. + :type user_id: str + + :param user_name: + The value to assign to the user_name property of this ServiceProviderInteractionSummary. + :type user_name: str + + :param message: + The value to assign to the message property of this ServiceProviderInteractionSummary. + :type message: str + + :param user_type: + The value to assign to the user_type property of this ServiceProviderInteractionSummary. + Allowed values for this property are: "CUSTOMER", "OPERATOR", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type user_type: str + + :param timestamp: + The value to assign to the timestamp property of this ServiceProviderInteractionSummary. + :type timestamp: datetime + + """ + self.swagger_types = { + 'message_identifier': 'str', + 'user_id': 'str', + 'user_name': 'str', + 'message': 'str', + 'user_type': 'str', + 'timestamp': 'datetime' + } + + self.attribute_map = { + 'message_identifier': 'messageIdentifier', + 'user_id': 'userId', + 'user_name': 'userName', + 'message': 'message', + 'user_type': 'userType', + 'timestamp': 'timestamp' + } + + self._message_identifier = None + self._user_id = None + self._user_name = None + self._message = None + self._user_type = None + self._timestamp = None + + @property + def message_identifier(self): + """ + Gets the message_identifier of this ServiceProviderInteractionSummary. + The unique identifier of the message within the scope of the associated access request. + + + :return: The message_identifier of this ServiceProviderInteractionSummary. + :rtype: str + """ + return self._message_identifier + + @message_identifier.setter + def message_identifier(self, message_identifier): + """ + Sets the message_identifier of this ServiceProviderInteractionSummary. + The unique identifier of the message within the scope of the associated access request. + + + :param message_identifier: The message_identifier of this ServiceProviderInteractionSummary. + :type: str + """ + self._message_identifier = message_identifier + + @property + def user_id(self): + """ + Gets the user_id of this ServiceProviderInteractionSummary. + ID of the customer or operator who is part of this conversation. For operator, this field is null. + + + :return: The user_id of this ServiceProviderInteractionSummary. + :rtype: str + """ + return self._user_id + + @user_id.setter + def user_id(self, user_id): + """ + Sets the user_id of this ServiceProviderInteractionSummary. + ID of the customer or operator who is part of this conversation. For operator, this field is null. + + + :param user_id: The user_id of this ServiceProviderInteractionSummary. + :type: str + """ + self._user_id = user_id + + @property + def user_name(self): + """ + Gets the user_name of this ServiceProviderInteractionSummary. + Name of the customer or operator who is part of this conversation. For operator, the name is \"Operator\". + + + :return: The user_name of this ServiceProviderInteractionSummary. + :rtype: str + """ + return self._user_name + + @user_name.setter + def user_name(self, user_name): + """ + Sets the user_name of this ServiceProviderInteractionSummary. + Name of the customer or operator who is part of this conversation. For operator, the name is \"Operator\". + + + :param user_name: The user_name of this ServiceProviderInteractionSummary. + :type: str + """ + self._user_name = user_name + + @property + def message(self): + """ + Gets the message of this ServiceProviderInteractionSummary. + The information exchanged between the customer and the operator. + + + :return: The message of this ServiceProviderInteractionSummary. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this ServiceProviderInteractionSummary. + The information exchanged between the customer and the operator. + + + :param message: The message of this ServiceProviderInteractionSummary. + :type: str + """ + self._message = message + + @property + def user_type(self): + """ + Gets the user_type of this ServiceProviderInteractionSummary. + Indicates whether the user is a customer or an operator. + + Allowed values for this property are: "CUSTOMER", "OPERATOR", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The user_type of this ServiceProviderInteractionSummary. + :rtype: str + """ + return self._user_type + + @user_type.setter + def user_type(self, user_type): + """ + Sets the user_type of this ServiceProviderInteractionSummary. + Indicates whether the user is a customer or an operator. + + + :param user_type: The user_type of this ServiceProviderInteractionSummary. + :type: str + """ + allowed_values = ["CUSTOMER", "OPERATOR"] + if not value_allowed_none_or_none_sentinel(user_type, allowed_values): + user_type = 'UNKNOWN_ENUM_VALUE' + self._user_type = user_type + + @property + def timestamp(self): + """ + Gets the timestamp of this ServiceProviderInteractionSummary. + Time when the conversation happened in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The timestamp of this ServiceProviderInteractionSummary. + :rtype: datetime + """ + return self._timestamp + + @timestamp.setter + def timestamp(self, timestamp): + """ + Sets the timestamp of this ServiceProviderInteractionSummary. + Time when the conversation happened in `RFC 3339`__timestamp format, e.g. '2020-05-22T21:10:29.600Z'. + + __ https://tools.ietf.org/html/rfc3339 + + + :param timestamp: The timestamp of this ServiceProviderInteractionSummary. + :type: datetime + """ + self._timestamp = timestamp + + 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/delegate_access_control/models/service_provider_summary.py b/src/oci/delegate_access_control/models/service_provider_summary.py new file mode 100644 index 0000000000..305b9bdec5 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_summary.py @@ -0,0 +1,508 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderSummary(object): + """ + Summary of the Service Provider. Service provider offers services to the customer to support the delegated resources. + """ + + #: A constant which can be used with the service_types property of a ServiceProviderSummary. + #: This constant has a value of "TROUBLESHOOTING" + SERVICE_TYPES_TROUBLESHOOTING = "TROUBLESHOOTING" + + #: A constant which can be used with the service_types property of a ServiceProviderSummary. + #: This constant has a value of "ASSISTED_PATCHING" + SERVICE_TYPES_ASSISTED_PATCHING = "ASSISTED_PATCHING" + + #: A constant which can be used with the supported_resource_types property of a ServiceProviderSummary. + #: This constant has a value of "VMCLUSTER" + SUPPORTED_RESOURCE_TYPES_VMCLUSTER = "VMCLUSTER" + + #: A constant which can be used with the supported_resource_types property of a ServiceProviderSummary. + #: This constant has a value of "CLOUDVMCLUSTER" + SUPPORTED_RESOURCE_TYPES_CLOUDVMCLUSTER = "CLOUDVMCLUSTER" + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderSummary 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 ServiceProviderSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this ServiceProviderSummary. + :type compartment_id: str + + :param name: + The value to assign to the name property of this ServiceProviderSummary. + :type name: str + + :param service_provider_type: + The value to assign to the service_provider_type property of this ServiceProviderSummary. + :type service_provider_type: str + + :param service_types: + The value to assign to the service_types property of this ServiceProviderSummary. + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type service_types: list[str] + + :param supported_resource_types: + The value to assign to the supported_resource_types property of this ServiceProviderSummary. + Allowed values for items in this list are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type supported_resource_types: list[str] + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this ServiceProviderSummary. + :type lifecycle_state: str + + :param lifecycle_state_details: + The value to assign to the lifecycle_state_details property of this ServiceProviderSummary. + :type lifecycle_state_details: str + + :param time_created: + The value to assign to the time_created property of this ServiceProviderSummary. + :type time_created: datetime + + :param time_updated: + The value to assign to the time_updated property of this ServiceProviderSummary. + :type time_updated: datetime + + :param freeform_tags: + The value to assign to the freeform_tags property of this ServiceProviderSummary. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this ServiceProviderSummary. + :type defined_tags: dict(str, dict(str, object)) + + :param system_tags: + The value to assign to the system_tags property of this ServiceProviderSummary. + :type system_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'id': 'str', + 'compartment_id': 'str', + 'name': 'str', + 'service_provider_type': 'str', + 'service_types': 'list[str]', + 'supported_resource_types': 'list[str]', + 'lifecycle_state': 'str', + 'lifecycle_state_details': 'str', + 'time_created': 'datetime', + 'time_updated': 'datetime', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'id': 'id', + 'compartment_id': 'compartmentId', + 'name': 'name', + 'service_provider_type': 'serviceProviderType', + 'service_types': 'serviceTypes', + 'supported_resource_types': 'supportedResourceTypes', + 'lifecycle_state': 'lifecycleState', + 'lifecycle_state_details': 'lifecycleStateDetails', + 'time_created': 'timeCreated', + 'time_updated': 'timeUpdated', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' + } + + self._id = None + self._compartment_id = None + self._name = None + self._service_provider_type = None + self._service_types = None + self._supported_resource_types = None + self._lifecycle_state = None + self._lifecycle_state_details = None + self._time_created = None + self._time_updated = None + self._freeform_tags = None + self._defined_tags = None + self._system_tags = None + + @property + def id(self): + """ + **[Required]** Gets the id of this ServiceProviderSummary. + Unique identifier for the Service Provider. + + + :return: The id of this ServiceProviderSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this ServiceProviderSummary. + Unique identifier for the Service Provider. + + + :param id: The id of this ServiceProviderSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + Gets the compartment_id of this ServiceProviderSummary. + The OCID of the compartment that contains the Delegation Control. + + + :return: The compartment_id of this ServiceProviderSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this ServiceProviderSummary. + The OCID of the compartment that contains the Delegation Control. + + + :param compartment_id: The compartment_id of this ServiceProviderSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def name(self): + """ + **[Required]** Gets the name of this ServiceProviderSummary. + Unique name of the Service Provider. + + + :return: The name of this ServiceProviderSummary. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this ServiceProviderSummary. + Unique name of the Service Provider. + + + :param name: The name of this ServiceProviderSummary. + :type: str + """ + self._name = name + + @property + def service_provider_type(self): + """ + Gets the service_provider_type of this ServiceProviderSummary. + Service Provider type. + + + :return: The service_provider_type of this ServiceProviderSummary. + :rtype: str + """ + return self._service_provider_type + + @service_provider_type.setter + def service_provider_type(self, service_provider_type): + """ + Sets the service_provider_type of this ServiceProviderSummary. + Service Provider type. + + + :param service_provider_type: The service_provider_type of this ServiceProviderSummary. + :type: str + """ + self._service_provider_type = service_provider_type + + @property + def service_types(self): + """ + Gets the service_types of this ServiceProviderSummary. + Types of services offered by this provider. + + Allowed values for items in this list are: "TROUBLESHOOTING", "ASSISTED_PATCHING", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The service_types of this ServiceProviderSummary. + :rtype: list[str] + """ + return self._service_types + + @service_types.setter + def service_types(self, service_types): + """ + Sets the service_types of this ServiceProviderSummary. + Types of services offered by this provider. + + + :param service_types: The service_types of this ServiceProviderSummary. + :type: list[str] + """ + allowed_values = ["TROUBLESHOOTING", "ASSISTED_PATCHING"] + if service_types: + service_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in service_types] + self._service_types = service_types + + @property + def supported_resource_types(self): + """ + Gets the supported_resource_types of this ServiceProviderSummary. + Resource types for which this provider will provide service. Default to all if not specified. + + Allowed values for items in this list are: "VMCLUSTER", "CLOUDVMCLUSTER", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The supported_resource_types of this ServiceProviderSummary. + :rtype: list[str] + """ + return self._supported_resource_types + + @supported_resource_types.setter + def supported_resource_types(self, supported_resource_types): + """ + Sets the supported_resource_types of this ServiceProviderSummary. + Resource types for which this provider will provide service. Default to all if not specified. + + + :param supported_resource_types: The supported_resource_types of this ServiceProviderSummary. + :type: list[str] + """ + allowed_values = ["VMCLUSTER", "CLOUDVMCLUSTER"] + if supported_resource_types: + supported_resource_types[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in supported_resource_types] + self._supported_resource_types = supported_resource_types + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this ServiceProviderSummary. + The current lifecycle state of the Service Provider. + + + :return: The lifecycle_state of this ServiceProviderSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this ServiceProviderSummary. + The current lifecycle state of the Service Provider. + + + :param lifecycle_state: The lifecycle_state of this ServiceProviderSummary. + :type: str + """ + self._lifecycle_state = lifecycle_state + + @property + def lifecycle_state_details(self): + """ + Gets the lifecycle_state_details of this ServiceProviderSummary. + Description of the current lifecycle state in more detail. + + + :return: The lifecycle_state_details of this ServiceProviderSummary. + :rtype: str + """ + return self._lifecycle_state_details + + @lifecycle_state_details.setter + def lifecycle_state_details(self, lifecycle_state_details): + """ + Sets the lifecycle_state_details of this ServiceProviderSummary. + Description of the current lifecycle state in more detail. + + + :param lifecycle_state_details: The lifecycle_state_details of this ServiceProviderSummary. + :type: str + """ + self._lifecycle_state_details = lifecycle_state_details + + @property + def time_created(self): + """ + Gets the time_created of this ServiceProviderSummary. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_created of this ServiceProviderSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this ServiceProviderSummary. + Time when the Service Provider was created expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_created: The time_created of this ServiceProviderSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_updated(self): + """ + Gets the time_updated of this ServiceProviderSummary. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :return: The time_updated of this ServiceProviderSummary. + :rtype: datetime + """ + return self._time_updated + + @time_updated.setter + def time_updated(self, time_updated): + """ + Sets the time_updated of this ServiceProviderSummary. + Time when the Service Provider was last modified expressed in `RFC 3339`__ timestamp format, e.g. '2020-05-22T21:10:29.600Z' + + __ https://tools.ietf.org/html/rfc3339 + + + :param time_updated: The time_updated of this ServiceProviderSummary. + :type: datetime + """ + self._time_updated = time_updated + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this ServiceProviderSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this ServiceProviderSummary. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this ServiceProviderSummary. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this ServiceProviderSummary. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this ServiceProviderSummary. + 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 ServiceProviderSummary. + :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 ServiceProviderSummary. + 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 ServiceProviderSummary. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def system_tags(self): + """ + Gets the system_tags of this ServiceProviderSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :return: The system_tags of this ServiceProviderSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this ServiceProviderSummary. + System tags for this resource. Each key is predefined and scoped to a namespace. + + Example: `{\"orcl-cloud\": {\"free-tier-retained\": \"true\"}}` + + + :param system_tags: The system_tags of this ServiceProviderSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_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/delegate_access_control/models/service_provider_summary_collection.py b/src/oci/delegate_access_control/models/service_provider_summary_collection.py new file mode 100644 index 0000000000..ea55954e27 --- /dev/null +++ b/src/oci/delegate_access_control/models/service_provider_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 ServiceProviderSummaryCollection(object): + """ + List of ServiceProviderSummary objects. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ServiceProviderSummaryCollection 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 ServiceProviderSummaryCollection. + :type items: list[oci.delegate_access_control.models.ServiceProviderSummary] + + """ + self.swagger_types = { + 'items': 'list[ServiceProviderSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this ServiceProviderSummaryCollection. + List of ServiceProviderSummary objects. + + + :return: The items of this ServiceProviderSummaryCollection. + :rtype: list[oci.delegate_access_control.models.ServiceProviderSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this ServiceProviderSummaryCollection. + List of ServiceProviderSummary objects. + + + :param items: The items of this ServiceProviderSummaryCollection. + :type: list[oci.delegate_access_control.models.ServiceProviderSummary] + """ + 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/delegate_access_control/models/update_delegation_control_details.py b/src/oci/delegate_access_control/models/update_delegation_control_details.py new file mode 100644 index 0000000000..dddcab7694 --- /dev/null +++ b/src/oci/delegate_access_control/models/update_delegation_control_details.py @@ -0,0 +1,404 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 UpdateDelegationControlDetails(object): + """ + Information about the new Delegation Control. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateDelegationControlDetails 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 UpdateDelegationControlDetails. + :type display_name: str + + :param description: + The value to assign to the description property of this UpdateDelegationControlDetails. + :type description: str + + :param num_approvals_required: + The value to assign to the num_approvals_required property of this UpdateDelegationControlDetails. + :type num_approvals_required: int + + :param delegation_subscription_ids: + The value to assign to the delegation_subscription_ids property of this UpdateDelegationControlDetails. + :type delegation_subscription_ids: list[str] + + :param is_auto_approve_during_maintenance: + The value to assign to the is_auto_approve_during_maintenance property of this UpdateDelegationControlDetails. + :type is_auto_approve_during_maintenance: bool + + :param resource_ids: + The value to assign to the resource_ids property of this UpdateDelegationControlDetails. + :type resource_ids: list[str] + + :param pre_approved_service_provider_action_names: + The value to assign to the pre_approved_service_provider_action_names property of this UpdateDelegationControlDetails. + :type pre_approved_service_provider_action_names: list[str] + + :param notification_topic_id: + The value to assign to the notification_topic_id property of this UpdateDelegationControlDetails. + :type notification_topic_id: str + + :param notification_message_format: + The value to assign to the notification_message_format property of this UpdateDelegationControlDetails. + :type notification_message_format: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateDelegationControlDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateDelegationControlDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'display_name': 'str', + 'description': 'str', + 'num_approvals_required': 'int', + 'delegation_subscription_ids': 'list[str]', + 'is_auto_approve_during_maintenance': 'bool', + 'resource_ids': 'list[str]', + 'pre_approved_service_provider_action_names': 'list[str]', + 'notification_topic_id': 'str', + 'notification_message_format': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'display_name': 'displayName', + 'description': 'description', + 'num_approvals_required': 'numApprovalsRequired', + 'delegation_subscription_ids': 'delegationSubscriptionIds', + 'is_auto_approve_during_maintenance': 'isAutoApproveDuringMaintenance', + 'resource_ids': 'resourceIds', + 'pre_approved_service_provider_action_names': 'preApprovedServiceProviderActionNames', + 'notification_topic_id': 'notificationTopicId', + 'notification_message_format': 'notificationMessageFormat', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._display_name = None + self._description = None + self._num_approvals_required = None + self._delegation_subscription_ids = None + self._is_auto_approve_during_maintenance = None + self._resource_ids = None + self._pre_approved_service_provider_action_names = None + self._notification_topic_id = None + self._notification_message_format = None + self._freeform_tags = None + self._defined_tags = None + + @property + def display_name(self): + """ + Gets the display_name of this UpdateDelegationControlDetails. + Name of the Delegation Control. The name does not need to be unique. + + + :return: The display_name of this UpdateDelegationControlDetails. + :rtype: str + """ + return self._display_name + + @display_name.setter + def display_name(self, display_name): + """ + Sets the display_name of this UpdateDelegationControlDetails. + Name of the Delegation Control. The name does not need to be unique. + + + :param display_name: The display_name of this UpdateDelegationControlDetails. + :type: str + """ + self._display_name = display_name + + @property + def description(self): + """ + Gets the description of this UpdateDelegationControlDetails. + Description of the Delegation Control. + + + :return: The description of this UpdateDelegationControlDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this UpdateDelegationControlDetails. + Description of the Delegation Control. + + + :param description: The description of this UpdateDelegationControlDetails. + :type: str + """ + self._description = description + + @property + def num_approvals_required(self): + """ + Gets the num_approvals_required of this UpdateDelegationControlDetails. + number of approvals required. + + + :return: The num_approvals_required of this UpdateDelegationControlDetails. + :rtype: int + """ + return self._num_approvals_required + + @num_approvals_required.setter + def num_approvals_required(self, num_approvals_required): + """ + Sets the num_approvals_required of this UpdateDelegationControlDetails. + number of approvals required. + + + :param num_approvals_required: The num_approvals_required of this UpdateDelegationControlDetails. + :type: int + """ + self._num_approvals_required = num_approvals_required + + @property + def delegation_subscription_ids(self): + """ + Gets the delegation_subscription_ids of this UpdateDelegationControlDetails. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :return: The delegation_subscription_ids of this UpdateDelegationControlDetails. + :rtype: list[str] + """ + return self._delegation_subscription_ids + + @delegation_subscription_ids.setter + def delegation_subscription_ids(self, delegation_subscription_ids): + """ + Sets the delegation_subscription_ids of this UpdateDelegationControlDetails. + List of Delegation Subscription OCID that are allowed for this Delegation Control. The allowed subscriptions will determine the available Service Provider Actions. Only support operators for the allowed subscriptions are allowed to create Delegated Resource Access Request. + + + :param delegation_subscription_ids: The delegation_subscription_ids of this UpdateDelegationControlDetails. + :type: list[str] + """ + self._delegation_subscription_ids = delegation_subscription_ids + + @property + def is_auto_approve_during_maintenance(self): + """ + Gets the is_auto_approve_during_maintenance of this UpdateDelegationControlDetails. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :return: The is_auto_approve_during_maintenance of this UpdateDelegationControlDetails. + :rtype: bool + """ + return self._is_auto_approve_during_maintenance + + @is_auto_approve_during_maintenance.setter + def is_auto_approve_during_maintenance(self, is_auto_approve_during_maintenance): + """ + Sets the is_auto_approve_during_maintenance of this UpdateDelegationControlDetails. + Set to true to allow all Delegated Resource Access Request to be approved automatically during maintenance. + + + :param is_auto_approve_during_maintenance: The is_auto_approve_during_maintenance of this UpdateDelegationControlDetails. + :type: bool + """ + self._is_auto_approve_during_maintenance = is_auto_approve_during_maintenance + + @property + def resource_ids(self): + """ + Gets the resource_ids of this UpdateDelegationControlDetails. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :return: The resource_ids of this UpdateDelegationControlDetails. + :rtype: list[str] + """ + return self._resource_ids + + @resource_ids.setter + def resource_ids(self, resource_ids): + """ + Sets the resource_ids of this UpdateDelegationControlDetails. + The OCID of the selected resources that this Delegation Control is applicable to. + + + :param resource_ids: The resource_ids of this UpdateDelegationControlDetails. + :type: list[str] + """ + self._resource_ids = resource_ids + + @property + def pre_approved_service_provider_action_names(self): + """ + Gets the pre_approved_service_provider_action_names of this UpdateDelegationControlDetails. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :return: The pre_approved_service_provider_action_names of this UpdateDelegationControlDetails. + :rtype: list[str] + """ + return self._pre_approved_service_provider_action_names + + @pre_approved_service_provider_action_names.setter + def pre_approved_service_provider_action_names(self, pre_approved_service_provider_action_names): + """ + Sets the pre_approved_service_provider_action_names of this UpdateDelegationControlDetails. + List of pre-approved Service Provider Action names. The list of pre-defined Service Provider Actions can be obtained from the ListServiceProviderActions API. Delegated Resource Access Requests associated with a resource governed by this Delegation Control will be + automatically approved if the Delegated Resource Access Request only contain Service Provider Actions in the pre-approved list. + + + :param pre_approved_service_provider_action_names: The pre_approved_service_provider_action_names of this UpdateDelegationControlDetails. + :type: list[str] + """ + self._pre_approved_service_provider_action_names = pre_approved_service_provider_action_names + + @property + def notification_topic_id(self): + """ + Gets the notification_topic_id of this UpdateDelegationControlDetails. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :return: The notification_topic_id of this UpdateDelegationControlDetails. + :rtype: str + """ + return self._notification_topic_id + + @notification_topic_id.setter + def notification_topic_id(self, notification_topic_id): + """ + Sets the notification_topic_id of this UpdateDelegationControlDetails. + The OCID of the OCI Notification topic to publish messages related to this Delegation Control. + + + :param notification_topic_id: The notification_topic_id of this UpdateDelegationControlDetails. + :type: str + """ + self._notification_topic_id = notification_topic_id + + @property + def notification_message_format(self): + """ + Gets the notification_message_format of this UpdateDelegationControlDetails. + The format of the OCI Notification messages for this Delegation Control. + + + :return: The notification_message_format of this UpdateDelegationControlDetails. + :rtype: str + """ + return self._notification_message_format + + @notification_message_format.setter + def notification_message_format(self, notification_message_format): + """ + Sets the notification_message_format of this UpdateDelegationControlDetails. + The format of the OCI Notification messages for this Delegation Control. + + + :param notification_message_format: The notification_message_format of this UpdateDelegationControlDetails. + :type: str + """ + self._notification_message_format = notification_message_format + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateDelegationControlDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateDelegationControlDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateDelegationControlDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateDelegationControlDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateDelegationControlDetails. + 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 UpdateDelegationControlDetails. + :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 UpdateDelegationControlDetails. + 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 UpdateDelegationControlDetails. + :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/delegate_access_control/models/update_delegation_subscription_details.py b/src/oci/delegate_access_control/models/update_delegation_subscription_details.py new file mode 100644 index 0000000000..f1038542ce --- /dev/null +++ b/src/oci/delegate_access_control/models/update_delegation_subscription_details.py @@ -0,0 +1,154 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 UpdateDelegationSubscriptionDetails(object): + """ + Details for updating the Delegation Subscription. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdateDelegationSubscriptionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param description: + The value to assign to the description property of this UpdateDelegationSubscriptionDetails. + :type description: str + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdateDelegationSubscriptionDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdateDelegationSubscriptionDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'description': 'str', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'description': 'description', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._description = None + self._freeform_tags = None + self._defined_tags = None + + @property + def description(self): + """ + Gets the description of this UpdateDelegationSubscriptionDetails. + Description of the Delegation Subscription. + + + :return: The description of this UpdateDelegationSubscriptionDetails. + :rtype: str + """ + return self._description + + @description.setter + def description(self, description): + """ + Sets the description of this UpdateDelegationSubscriptionDetails. + Description of the Delegation Subscription. + + + :param description: The description of this UpdateDelegationSubscriptionDetails. + :type: str + """ + self._description = description + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdateDelegationSubscriptionDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :return: The freeform_tags of this UpdateDelegationSubscriptionDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdateDelegationSubscriptionDetails. + 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/iaas/Content/General/Concepts/resourcetags.htm + + + :param freeform_tags: The freeform_tags of this UpdateDelegationSubscriptionDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdateDelegationSubscriptionDetails. + 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 UpdateDelegationSubscriptionDetails. + :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 UpdateDelegationSubscriptionDetails. + 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 UpdateDelegationSubscriptionDetails. + :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/delegate_access_control/models/work_request.py b/src/oci/delegate_access_control/models/work_request.py new file mode 100644 index 0000000000..e22bf277ea --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request.py @@ -0,0 +1,438 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequest(object): + """ + A description of workrequest status + """ + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "CREATE_DELEGATION_CONTROL" + OPERATION_TYPE_CREATE_DELEGATION_CONTROL = "CREATE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "UPDATE_DELEGATION_CONTROL" + OPERATION_TYPE_UPDATE_DELEGATION_CONTROL = "UPDATE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DELETE_DELEGATION_CONTROL" + OPERATION_TYPE_DELETE_DELEGATION_CONTROL = "DELETE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "MOVE_DELEGATION_CONTROL" + OPERATION_TYPE_MOVE_DELEGATION_CONTROL = "MOVE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST = "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST = "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST = "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST = "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "CREATE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_CREATE_DELEGATION_SUBSCRIPTION = "CREATE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "UPDATE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_UPDATE_DELEGATION_SUBSCRIPTION = "UPDATE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DELETE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_DELETE_DELEGATION_SUBSCRIPTION = "DELETE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "MOVE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_MOVE_DELEGATION_SUBSCRIPTION = "MOVE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "ACCEPTED" + STATUS_ACCEPTED = "ACCEPTED" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "IN_PROGRESS" + STATUS_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "WAITING" + STATUS_WAITING = "WAITING" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "NEEDS_ATTENTION" + STATUS_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "FAILED" + STATUS_FAILED = "FAILED" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "SUCCEEDED" + STATUS_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "CANCELING" + STATUS_CANCELING = "CANCELING" + + #: A constant which can be used with the status property of a WorkRequest. + #: This constant has a value of "CANCELED" + STATUS_CANCELED = "CANCELED" + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequest object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param operation_type: + The value to assign to the operation_type property of this WorkRequest. + Allowed values for this property are: "CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type operation_type: str + + :param status: + The value to assign to the status property of this WorkRequest. + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type status: str + + :param id: + The value to assign to the id property of this WorkRequest. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this WorkRequest. + :type compartment_id: str + + :param resources: + The value to assign to the resources property of this WorkRequest. + :type resources: list[oci.delegate_access_control.models.WorkRequestResource] + + :param percent_complete: + The value to assign to the percent_complete property of this WorkRequest. + :type percent_complete: float + + :param time_accepted: + The value to assign to the time_accepted property of this WorkRequest. + :type time_accepted: datetime + + :param time_started: + The value to assign to the time_started property of this WorkRequest. + :type time_started: datetime + + :param time_finished: + The value to assign to the time_finished property of this WorkRequest. + :type time_finished: datetime + + """ + self.swagger_types = { + 'operation_type': 'str', + 'status': 'str', + 'id': 'str', + 'compartment_id': 'str', + 'resources': 'list[WorkRequestResource]', + 'percent_complete': 'float', + 'time_accepted': 'datetime', + 'time_started': 'datetime', + 'time_finished': 'datetime' + } + + self.attribute_map = { + 'operation_type': 'operationType', + 'status': 'status', + 'id': 'id', + 'compartment_id': 'compartmentId', + 'resources': 'resources', + 'percent_complete': 'percentComplete', + 'time_accepted': 'timeAccepted', + 'time_started': 'timeStarted', + 'time_finished': 'timeFinished' + } + + self._operation_type = None + self._status = None + self._id = None + self._compartment_id = None + self._resources = None + self._percent_complete = None + self._time_accepted = None + self._time_started = None + self._time_finished = None + + @property + def operation_type(self): + """ + **[Required]** Gets the operation_type of this WorkRequest. + Type of the work request + + Allowed values for this property are: "CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The operation_type of this WorkRequest. + :rtype: str + """ + return self._operation_type + + @operation_type.setter + def operation_type(self, operation_type): + """ + Sets the operation_type of this WorkRequest. + Type of the work request + + + :param operation_type: The operation_type of this WorkRequest. + :type: str + """ + allowed_values = ["CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION"] + if not value_allowed_none_or_none_sentinel(operation_type, allowed_values): + operation_type = 'UNKNOWN_ENUM_VALUE' + self._operation_type = operation_type + + @property + def status(self): + """ + **[Required]** Gets the status of this WorkRequest. + Status of current work request. + + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The status of this WorkRequest. + :rtype: str + """ + return self._status + + @status.setter + def status(self, status): + """ + Sets the status of this WorkRequest. + Status of current work request. + + + :param status: The status of this WorkRequest. + :type: str + """ + allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"] + if not value_allowed_none_or_none_sentinel(status, allowed_values): + status = 'UNKNOWN_ENUM_VALUE' + self._status = status + + @property + def id(self): + """ + **[Required]** Gets the id of this WorkRequest. + The id of the work request. + + + :return: The id of this WorkRequest. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this WorkRequest. + The id of the work request. + + + :param id: The id of this WorkRequest. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this WorkRequest. + The ocid of the compartment that contains the work request. Work requests should be scoped to + the same compartment as the resource the work request affects. If the work request affects multiple resources, + and those resources are not in the same compartment, it is up to the service team to pick the primary + resource whose compartment should be used + + + :return: The compartment_id of this WorkRequest. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this WorkRequest. + The ocid of the compartment that contains the work request. Work requests should be scoped to + the same compartment as the resource the work request affects. If the work request affects multiple resources, + and those resources are not in the same compartment, it is up to the service team to pick the primary + resource whose compartment should be used + + + :param compartment_id: The compartment_id of this WorkRequest. + :type: str + """ + self._compartment_id = compartment_id + + @property + def resources(self): + """ + **[Required]** Gets the resources of this WorkRequest. + The resources affected by this work request. + + + :return: The resources of this WorkRequest. + :rtype: list[oci.delegate_access_control.models.WorkRequestResource] + """ + return self._resources + + @resources.setter + def resources(self, resources): + """ + Sets the resources of this WorkRequest. + The resources affected by this work request. + + + :param resources: The resources of this WorkRequest. + :type: list[oci.delegate_access_control.models.WorkRequestResource] + """ + self._resources = resources + + @property + def percent_complete(self): + """ + **[Required]** Gets the percent_complete of this WorkRequest. + Percentage of the request completed. + + + :return: The percent_complete of this WorkRequest. + :rtype: float + """ + return self._percent_complete + + @percent_complete.setter + def percent_complete(self, percent_complete): + """ + Sets the percent_complete of this WorkRequest. + Percentage of the request completed. + + + :param percent_complete: The percent_complete of this WorkRequest. + :type: float + """ + self._percent_complete = percent_complete + + @property + def time_accepted(self): + """ + **[Required]** Gets the time_accepted of this WorkRequest. + The date and time the request was created, as described in + `RFC 3339`__, section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_accepted of this WorkRequest. + :rtype: datetime + """ + return self._time_accepted + + @time_accepted.setter + def time_accepted(self, time_accepted): + """ + Sets the time_accepted of this WorkRequest. + The date and time the request was created, as described in + `RFC 3339`__, section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_accepted: The time_accepted of this WorkRequest. + :type: datetime + """ + self._time_accepted = time_accepted + + @property + def time_started(self): + """ + Gets the time_started of this WorkRequest. + The date and time the request was started, as described in `RFC 3339`__, + section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_started of this WorkRequest. + :rtype: datetime + """ + return self._time_started + + @time_started.setter + def time_started(self, time_started): + """ + Sets the time_started of this WorkRequest. + The date and time the request was started, as described in `RFC 3339`__, + section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_started: The time_started of this WorkRequest. + :type: datetime + """ + self._time_started = time_started + + @property + def time_finished(self): + """ + Gets the time_finished of this WorkRequest. + The date and time the object was finished, as described in `RFC 3339`__. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_finished of this WorkRequest. + :rtype: datetime + """ + return self._time_finished + + @time_finished.setter + def time_finished(self, time_finished): + """ + Sets the time_finished of this WorkRequest. + The date and time the object was finished, as described in `RFC 3339`__. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_finished: The time_finished of this WorkRequest. + :type: datetime + """ + self._time_finished = time_finished + + 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/delegate_access_control/models/work_request_error.py b/src/oci/delegate_access_control/models/work_request_error.py new file mode 100644 index 0000000000..025288b885 --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_error.py @@ -0,0 +1,136 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestError(object): + """ + An error encountered while executing a work request. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestError object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param code: + The value to assign to the code property of this WorkRequestError. + :type code: str + + :param message: + The value to assign to the message property of this WorkRequestError. + :type message: str + + :param timestamp: + The value to assign to the timestamp property of this WorkRequestError. + :type timestamp: datetime + + """ + self.swagger_types = { + 'code': 'str', + 'message': 'str', + 'timestamp': 'datetime' + } + + self.attribute_map = { + 'code': 'code', + 'message': 'message', + 'timestamp': 'timestamp' + } + + self._code = None + self._message = None + self._timestamp = None + + @property + def code(self): + """ + **[Required]** Gets the code of this WorkRequestError. + A machine-usable code for the error that occured. Error codes are listed on + (https://docs.cloud.oracle.com/Content/API/References/apierrors.htm) + + + :return: The code of this WorkRequestError. + :rtype: str + """ + return self._code + + @code.setter + def code(self, code): + """ + Sets the code of this WorkRequestError. + A machine-usable code for the error that occured. Error codes are listed on + (https://docs.cloud.oracle.com/Content/API/References/apierrors.htm) + + + :param code: The code of this WorkRequestError. + :type: str + """ + self._code = code + + @property + def message(self): + """ + **[Required]** Gets the message of this WorkRequestError. + A human readable description of the issue encountered. + + + :return: The message of this WorkRequestError. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this WorkRequestError. + A human readable description of the issue encountered. + + + :param message: The message of this WorkRequestError. + :type: str + """ + self._message = message + + @property + def timestamp(self): + """ + **[Required]** Gets the timestamp of this WorkRequestError. + The time the error occured. An RFC3339 formatted datetime string. + + + :return: The timestamp of this WorkRequestError. + :rtype: datetime + """ + return self._timestamp + + @timestamp.setter + def timestamp(self, timestamp): + """ + Sets the timestamp of this WorkRequestError. + The time the error occured. An RFC3339 formatted datetime string. + + + :param timestamp: The timestamp of this WorkRequestError. + :type: datetime + """ + self._timestamp = timestamp + + 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/delegate_access_control/models/work_request_error_collection.py b/src/oci/delegate_access_control/models/work_request_error_collection.py new file mode 100644 index 0000000000..d43fc15397 --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_error_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestErrorCollection(object): + """ + Results of a workRequestError search. Contains both WorkRequestError items and other information, such as metadata. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestErrorCollection 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 WorkRequestErrorCollection. + :type items: list[oci.delegate_access_control.models.WorkRequestError] + + """ + self.swagger_types = { + 'items': 'list[WorkRequestError]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this WorkRequestErrorCollection. + List of workRequestError objects. + + + :return: The items of this WorkRequestErrorCollection. + :rtype: list[oci.delegate_access_control.models.WorkRequestError] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this WorkRequestErrorCollection. + List of workRequestError objects. + + + :param items: The items of this WorkRequestErrorCollection. + :type: list[oci.delegate_access_control.models.WorkRequestError] + """ + 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/delegate_access_control/models/work_request_log_entry.py b/src/oci/delegate_access_control/models/work_request_log_entry.py new file mode 100644 index 0000000000..e25a0f3b55 --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_log_entry.py @@ -0,0 +1,103 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestLogEntry(object): + """ + A log message from the execution of a work request. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestLogEntry object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param message: + The value to assign to the message property of this WorkRequestLogEntry. + :type message: str + + :param timestamp: + The value to assign to the timestamp property of this WorkRequestLogEntry. + :type timestamp: datetime + + """ + self.swagger_types = { + 'message': 'str', + 'timestamp': 'datetime' + } + + self.attribute_map = { + 'message': 'message', + 'timestamp': 'timestamp' + } + + self._message = None + self._timestamp = None + + @property + def message(self): + """ + **[Required]** Gets the message of this WorkRequestLogEntry. + Human-readable log message. + + + :return: The message of this WorkRequestLogEntry. + :rtype: str + """ + return self._message + + @message.setter + def message(self, message): + """ + Sets the message of this WorkRequestLogEntry. + Human-readable log message. + + + :param message: The message of this WorkRequestLogEntry. + :type: str + """ + self._message = message + + @property + def timestamp(self): + """ + **[Required]** Gets the timestamp of this WorkRequestLogEntry. + The time the log message was written. An RFC3339 formatted datetime string + + + :return: The timestamp of this WorkRequestLogEntry. + :rtype: datetime + """ + return self._timestamp + + @timestamp.setter + def timestamp(self, timestamp): + """ + Sets the timestamp of this WorkRequestLogEntry. + The time the log message was written. An RFC3339 formatted datetime string + + + :param timestamp: The timestamp of this WorkRequestLogEntry. + :type: datetime + """ + self._timestamp = timestamp + + 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/delegate_access_control/models/work_request_log_entry_collection.py b/src/oci/delegate_access_control/models/work_request_log_entry_collection.py new file mode 100644 index 0000000000..5779ad7ffa --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_log_entry_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestLogEntryCollection(object): + """ + Results of a workRequestLog search. Contains both workRequestLog items and other information, such as metadata. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestLogEntryCollection 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 WorkRequestLogEntryCollection. + :type items: list[oci.delegate_access_control.models.WorkRequestLogEntry] + + """ + self.swagger_types = { + 'items': 'list[WorkRequestLogEntry]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this WorkRequestLogEntryCollection. + List of workRequestLogEntries. + + + :return: The items of this WorkRequestLogEntryCollection. + :rtype: list[oci.delegate_access_control.models.WorkRequestLogEntry] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this WorkRequestLogEntryCollection. + List of workRequestLogEntries. + + + :param items: The items of this WorkRequestLogEntryCollection. + :type: list[oci.delegate_access_control.models.WorkRequestLogEntry] + """ + 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/delegate_access_control/models/work_request_resource.py b/src/oci/delegate_access_control/models/work_request_resource.py new file mode 100644 index 0000000000..e64d463c9e --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_resource.py @@ -0,0 +1,234 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestResource(object): + """ + A resource created or operated on by a work request. + """ + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "CREATED" + ACTION_TYPE_CREATED = "CREATED" + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "UPDATED" + ACTION_TYPE_UPDATED = "UPDATED" + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "DELETED" + ACTION_TYPE_DELETED = "DELETED" + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "IN_PROGRESS" + ACTION_TYPE_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "RELATED" + ACTION_TYPE_RELATED = "RELATED" + + #: A constant which can be used with the action_type property of a WorkRequestResource. + #: This constant has a value of "FAILED" + ACTION_TYPE_FAILED = "FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestResource object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param entity_type: + The value to assign to the entity_type property of this WorkRequestResource. + :type entity_type: str + + :param action_type: + The value to assign to the action_type property of this WorkRequestResource. + Allowed values for this property are: "CREATED", "UPDATED", "DELETED", "IN_PROGRESS", "RELATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type action_type: str + + :param identifier: + The value to assign to the identifier property of this WorkRequestResource. + :type identifier: str + + :param entity_uri: + The value to assign to the entity_uri property of this WorkRequestResource. + :type entity_uri: str + + :param metadata: + The value to assign to the metadata property of this WorkRequestResource. + :type metadata: dict(str, str) + + """ + self.swagger_types = { + 'entity_type': 'str', + 'action_type': 'str', + 'identifier': 'str', + 'entity_uri': 'str', + 'metadata': 'dict(str, str)' + } + + self.attribute_map = { + 'entity_type': 'entityType', + 'action_type': 'actionType', + 'identifier': 'identifier', + 'entity_uri': 'entityUri', + 'metadata': 'metadata' + } + + self._entity_type = None + self._action_type = None + self._identifier = None + self._entity_uri = None + self._metadata = None + + @property + def entity_type(self): + """ + **[Required]** Gets the entity_type of this WorkRequestResource. + The resource type the work request affects. + + + :return: The entity_type of this WorkRequestResource. + :rtype: str + """ + return self._entity_type + + @entity_type.setter + def entity_type(self, entity_type): + """ + Sets the entity_type of this WorkRequestResource. + The resource type the work request affects. + + + :param entity_type: The entity_type of this WorkRequestResource. + :type: str + """ + self._entity_type = entity_type + + @property + def action_type(self): + """ + **[Required]** Gets the action_type of this WorkRequestResource. + The way in which this resource is affected by the work tracked in the work request. + A resource being created, updated, or deleted will remain in the IN_PROGRESS state until + work is complete for that resource at which point it will transition to CREATED, UPDATED, + or DELETED, respectively. + + Allowed values for this property are: "CREATED", "UPDATED", "DELETED", "IN_PROGRESS", "RELATED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The action_type of this WorkRequestResource. + :rtype: str + """ + return self._action_type + + @action_type.setter + def action_type(self, action_type): + """ + Sets the action_type of this WorkRequestResource. + The way in which this resource is affected by the work tracked in the work request. + A resource being created, updated, or deleted will remain in the IN_PROGRESS state until + work is complete for that resource at which point it will transition to CREATED, UPDATED, + or DELETED, respectively. + + + :param action_type: The action_type of this WorkRequestResource. + :type: str + """ + allowed_values = ["CREATED", "UPDATED", "DELETED", "IN_PROGRESS", "RELATED", "FAILED"] + if not value_allowed_none_or_none_sentinel(action_type, allowed_values): + action_type = 'UNKNOWN_ENUM_VALUE' + self._action_type = action_type + + @property + def identifier(self): + """ + **[Required]** Gets the identifier of this WorkRequestResource. + The identifier of the resource the work request affects. + + + :return: The identifier of this WorkRequestResource. + :rtype: str + """ + return self._identifier + + @identifier.setter + def identifier(self, identifier): + """ + Sets the identifier of this WorkRequestResource. + The identifier of the resource the work request affects. + + + :param identifier: The identifier of this WorkRequestResource. + :type: str + """ + self._identifier = identifier + + @property + def entity_uri(self): + """ + Gets the entity_uri of this WorkRequestResource. + The URI path that the user can do a GET on to access the resource metadata + + + :return: The entity_uri of this WorkRequestResource. + :rtype: str + """ + return self._entity_uri + + @entity_uri.setter + def entity_uri(self, entity_uri): + """ + Sets the entity_uri of this WorkRequestResource. + The URI path that the user can do a GET on to access the resource metadata + + + :param entity_uri: The entity_uri of this WorkRequestResource. + :type: str + """ + self._entity_uri = entity_uri + + @property + def metadata(self): + """ + Gets the metadata of this WorkRequestResource. + Additional information that helps to explain the resource. + + + :return: The metadata of this WorkRequestResource. + :rtype: dict(str, str) + """ + return self._metadata + + @metadata.setter + def metadata(self, metadata): + """ + Sets the metadata of this WorkRequestResource. + Additional information that helps to explain the resource. + + + :param metadata: The metadata of this WorkRequestResource. + :type: dict(str, str) + """ + self._metadata = metadata + + 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/delegate_access_control/models/work_request_summary.py b/src/oci/delegate_access_control/models/work_request_summary.py new file mode 100644 index 0000000000..cfb96daddf --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_summary.py @@ -0,0 +1,438 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestSummary(object): + """ + A summary of the status of a work request. + """ + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "CREATE_DELEGATION_CONTROL" + OPERATION_TYPE_CREATE_DELEGATION_CONTROL = "CREATE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "UPDATE_DELEGATION_CONTROL" + OPERATION_TYPE_UPDATE_DELEGATION_CONTROL = "UPDATE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "DELETE_DELEGATION_CONTROL" + OPERATION_TYPE_DELETE_DELEGATION_CONTROL = "DELETE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "MOVE_DELEGATION_CONTROL" + OPERATION_TYPE_MOVE_DELEGATION_CONTROL = "MOVE_DELEGATION_CONTROL" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST = "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST = "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST = "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST" + OPERATION_TYPE_REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST = "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "CREATE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_CREATE_DELEGATION_SUBSCRIPTION = "CREATE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "UPDATE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_UPDATE_DELEGATION_SUBSCRIPTION = "UPDATE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "DELETE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_DELETE_DELEGATION_SUBSCRIPTION = "DELETE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "MOVE_DELEGATION_SUBSCRIPTION" + OPERATION_TYPE_MOVE_DELEGATION_SUBSCRIPTION = "MOVE_DELEGATION_SUBSCRIPTION" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "ACCEPTED" + STATUS_ACCEPTED = "ACCEPTED" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "IN_PROGRESS" + STATUS_IN_PROGRESS = "IN_PROGRESS" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "WAITING" + STATUS_WAITING = "WAITING" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "NEEDS_ATTENTION" + STATUS_NEEDS_ATTENTION = "NEEDS_ATTENTION" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "FAILED" + STATUS_FAILED = "FAILED" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "SUCCEEDED" + STATUS_SUCCEEDED = "SUCCEEDED" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "CANCELING" + STATUS_CANCELING = "CANCELING" + + #: A constant which can be used with the status property of a WorkRequestSummary. + #: This constant has a value of "CANCELED" + STATUS_CANCELED = "CANCELED" + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param operation_type: + The value to assign to the operation_type property of this WorkRequestSummary. + Allowed values for this property are: "CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type operation_type: str + + :param status: + The value to assign to the status property of this WorkRequestSummary. + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type status: str + + :param id: + The value to assign to the id property of this WorkRequestSummary. + :type id: str + + :param compartment_id: + The value to assign to the compartment_id property of this WorkRequestSummary. + :type compartment_id: str + + :param resources: + The value to assign to the resources property of this WorkRequestSummary. + :type resources: list[oci.delegate_access_control.models.WorkRequestResource] + + :param percent_complete: + The value to assign to the percent_complete property of this WorkRequestSummary. + :type percent_complete: float + + :param time_accepted: + The value to assign to the time_accepted property of this WorkRequestSummary. + :type time_accepted: datetime + + :param time_started: + The value to assign to the time_started property of this WorkRequestSummary. + :type time_started: datetime + + :param time_finished: + The value to assign to the time_finished property of this WorkRequestSummary. + :type time_finished: datetime + + """ + self.swagger_types = { + 'operation_type': 'str', + 'status': 'str', + 'id': 'str', + 'compartment_id': 'str', + 'resources': 'list[WorkRequestResource]', + 'percent_complete': 'float', + 'time_accepted': 'datetime', + 'time_started': 'datetime', + 'time_finished': 'datetime' + } + + self.attribute_map = { + 'operation_type': 'operationType', + 'status': 'status', + 'id': 'id', + 'compartment_id': 'compartmentId', + 'resources': 'resources', + 'percent_complete': 'percentComplete', + 'time_accepted': 'timeAccepted', + 'time_started': 'timeStarted', + 'time_finished': 'timeFinished' + } + + self._operation_type = None + self._status = None + self._id = None + self._compartment_id = None + self._resources = None + self._percent_complete = None + self._time_accepted = None + self._time_started = None + self._time_finished = None + + @property + def operation_type(self): + """ + **[Required]** Gets the operation_type of this WorkRequestSummary. + Type of the work request + + Allowed values for this property are: "CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The operation_type of this WorkRequestSummary. + :rtype: str + """ + return self._operation_type + + @operation_type.setter + def operation_type(self, operation_type): + """ + Sets the operation_type of this WorkRequestSummary. + Type of the work request + + + :param operation_type: The operation_type of this WorkRequestSummary. + :type: str + """ + allowed_values = ["CREATE_DELEGATION_CONTROL", "UPDATE_DELEGATION_CONTROL", "DELETE_DELEGATION_CONTROL", "MOVE_DELEGATION_CONTROL", "CREATE_DELEGATED_RESOURCE_ACCESS_REQUEST", "APPROVE_DELEGATED_RESOURCE_ACCESS_REQUEST", "REJECT_DELEGATED_RESOURCE_ACCESS_REQUEST", "REVOKE_DELEGATED_RESOURCE_ACCESS_REQUEST", "CREATE_DELEGATION_SUBSCRIPTION", "UPDATE_DELEGATION_SUBSCRIPTION", "DELETE_DELEGATION_SUBSCRIPTION", "MOVE_DELEGATION_SUBSCRIPTION"] + if not value_allowed_none_or_none_sentinel(operation_type, allowed_values): + operation_type = 'UNKNOWN_ENUM_VALUE' + self._operation_type = operation_type + + @property + def status(self): + """ + **[Required]** Gets the status of this WorkRequestSummary. + Status of current work request. + + Allowed values for this property are: "ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The status of this WorkRequestSummary. + :rtype: str + """ + return self._status + + @status.setter + def status(self, status): + """ + Sets the status of this WorkRequestSummary. + Status of current work request. + + + :param status: The status of this WorkRequestSummary. + :type: str + """ + allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"] + if not value_allowed_none_or_none_sentinel(status, allowed_values): + status = 'UNKNOWN_ENUM_VALUE' + self._status = status + + @property + def id(self): + """ + **[Required]** Gets the id of this WorkRequestSummary. + The id of the work request. + + + :return: The id of this WorkRequestSummary. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this WorkRequestSummary. + The id of the work request. + + + :param id: The id of this WorkRequestSummary. + :type: str + """ + self._id = id + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this WorkRequestSummary. + The ocid of the compartment that contains the work request. Work requests should be scoped to + the same compartment as the resource the work request affects. If the work request affects multiple resources, + and those resources are not in the same compartment, it is up to the service team to pick the primary + resource whose compartment should be used + + + :return: The compartment_id of this WorkRequestSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this WorkRequestSummary. + The ocid of the compartment that contains the work request. Work requests should be scoped to + the same compartment as the resource the work request affects. If the work request affects multiple resources, + and those resources are not in the same compartment, it is up to the service team to pick the primary + resource whose compartment should be used + + + :param compartment_id: The compartment_id of this WorkRequestSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def resources(self): + """ + **[Required]** Gets the resources of this WorkRequestSummary. + The resources affected by this work request. + + + :return: The resources of this WorkRequestSummary. + :rtype: list[oci.delegate_access_control.models.WorkRequestResource] + """ + return self._resources + + @resources.setter + def resources(self, resources): + """ + Sets the resources of this WorkRequestSummary. + The resources affected by this work request. + + + :param resources: The resources of this WorkRequestSummary. + :type: list[oci.delegate_access_control.models.WorkRequestResource] + """ + self._resources = resources + + @property + def percent_complete(self): + """ + **[Required]** Gets the percent_complete of this WorkRequestSummary. + Percentage of the request completed. + + + :return: The percent_complete of this WorkRequestSummary. + :rtype: float + """ + return self._percent_complete + + @percent_complete.setter + def percent_complete(self, percent_complete): + """ + Sets the percent_complete of this WorkRequestSummary. + Percentage of the request completed. + + + :param percent_complete: The percent_complete of this WorkRequestSummary. + :type: float + """ + self._percent_complete = percent_complete + + @property + def time_accepted(self): + """ + **[Required]** Gets the time_accepted of this WorkRequestSummary. + The date and time the request was created, as described in + `RFC 3339`__, section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_accepted of this WorkRequestSummary. + :rtype: datetime + """ + return self._time_accepted + + @time_accepted.setter + def time_accepted(self, time_accepted): + """ + Sets the time_accepted of this WorkRequestSummary. + The date and time the request was created, as described in + `RFC 3339`__, section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_accepted: The time_accepted of this WorkRequestSummary. + :type: datetime + """ + self._time_accepted = time_accepted + + @property + def time_started(self): + """ + Gets the time_started of this WorkRequestSummary. + The date and time the request was started, as described in `RFC 3339`__, + section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_started of this WorkRequestSummary. + :rtype: datetime + """ + return self._time_started + + @time_started.setter + def time_started(self, time_started): + """ + Sets the time_started of this WorkRequestSummary. + The date and time the request was started, as described in `RFC 3339`__, + section 14.29. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_started: The time_started of this WorkRequestSummary. + :type: datetime + """ + self._time_started = time_started + + @property + def time_finished(self): + """ + Gets the time_finished of this WorkRequestSummary. + The date and time the object was finished, as described in `RFC 3339`__. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_finished of this WorkRequestSummary. + :rtype: datetime + """ + return self._time_finished + + @time_finished.setter + def time_finished(self, time_finished): + """ + Sets the time_finished of this WorkRequestSummary. + The date and time the object was finished, as described in `RFC 3339`__. + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_finished: The time_finished of this WorkRequestSummary. + :type: datetime + """ + self._time_finished = time_finished + + 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/delegate_access_control/models/work_request_summary_collection.py b/src/oci/delegate_access_control/models/work_request_summary_collection.py new file mode 100644 index 0000000000..0b0bd2a7a5 --- /dev/null +++ b/src/oci/delegate_access_control/models/work_request_summary_collection.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + + +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 WorkRequestSummaryCollection(object): + """ + Results of a workRequest search. Contains both WorkRequest items and other information, such as metadata. + """ + + def __init__(self, **kwargs): + """ + Initializes a new WorkRequestSummaryCollection 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 WorkRequestSummaryCollection. + :type items: list[oci.delegate_access_control.models.WorkRequestSummary] + + """ + self.swagger_types = { + 'items': 'list[WorkRequestSummary]' + } + + self.attribute_map = { + 'items': 'items' + } + + self._items = None + + @property + def items(self): + """ + **[Required]** Gets the items of this WorkRequestSummaryCollection. + List of workRequestSummary objects. + + + :return: The items of this WorkRequestSummaryCollection. + :rtype: list[oci.delegate_access_control.models.WorkRequestSummary] + """ + return self._items + + @items.setter + def items(self, items): + """ + Sets the items of this WorkRequestSummaryCollection. + List of workRequestSummary objects. + + + :param items: The items of this WorkRequestSummaryCollection. + :type: list[oci.delegate_access_control.models.WorkRequestSummary] + """ + 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/delegate_access_control/work_request_client.py b/src/oci/delegate_access_control/work_request_client.py new file mode 100644 index 0000000000..4f32c50495 --- /dev/null +++ b/src/oci/delegate_access_control/work_request_client.py @@ -0,0 +1,660 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +from __future__ import absolute_import + +from oci._vendor import requests # noqa: F401 +from oci._vendor import six + +from oci import retry, circuit_breaker # noqa: F401 +from oci.base_client import BaseClient +from oci.config import get_config_value_or_default, validate_config +from oci.signer import Signer +from oci.util import Sentinel, get_signer_from_authentication_type, AUTHENTICATION_TYPE_FIELD_NAME +from oci.exceptions import InvalidAlloyConfig +from oci.alloy import OCI_SDK_ENABLED_SERVICES_SET +from .models import delegate_access_control_type_mapping +missing = Sentinel("Missing") + + +class WorkRequestClient(object): + """ + Oracle Delegate Access Control allows ExaCC and ExaCS customers to delegate management of their Exadata resources operators outside their tenancies. + With Delegate Access Control, Support Providers can deliver managed services using comprehensive and robust tooling built on the OCI platform. + Customers maintain control over who has access to the delegated resources in their tenancy and what actions can be taken. + Enterprises managing resources across multiple tenants can use Delegate Access Control to streamline management tasks. + Using logging service, customers can view a near real-time audit report of all actions performed by a Service Provider operator. + """ + + def __init__(self, config, **kwargs): + """ + Creates a new service client + + :param dict config: + Configuration keys and values as per `SDK and Tool Configuration `__. + The :py:meth:`~oci.config.from_file` method can be used to load configuration from a file. Alternatively, a ``dict`` can be passed. You can validate_config + the dict using :py:meth:`~oci.config.validate_config` + + :param str service_endpoint: (optional) + The endpoint of the service to call using this client. For example ``https://iaas.us-ashburn-1.oraclecloud.com``. If this keyword argument is + not provided then it will be derived using the region in the config parameter. You should only provide this keyword argument if you have an explicit + need to specify a service endpoint. + + :param timeout: (optional) + The connection and read timeouts for the client. The default values are connection timeout 10 seconds and read timeout 60 seconds. This keyword argument can be provided + as a single float, in which case the value provided is used for both the read and connection timeouts, or as a tuple of two floats. If + a tuple is provided then the first value is used as the connection timeout and the second value as the read timeout. + :type timeout: float or tuple(float, float) + + :param signer: (optional) + The signer to use when signing requests made by the service client. The default is to use a :py:class:`~oci.signer.Signer` based on the values + provided in the config parameter. + + One use case for this parameter is for `Instance Principals authentication `__ + by passing an instance of :py:class:`~oci.auth.signers.InstancePrincipalsSecurityTokenSigner` as the value for this keyword argument + :type signer: :py:class:`~oci.signer.AbstractBaseSigner` + + :param obj retry_strategy: (optional) + A retry strategy to apply to all calls made by this service client (i.e. at the client level). There is no retry strategy applied by default. + Retry strategies can also be applied at the operation level by passing a ``retry_strategy`` keyword argument as part of calling the operation. + Any value provided at the operation level will override whatever is specified at the client level. + + This should be one of the strategies available in the :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 obj circuit_breaker_strategy: (optional) + A circuit breaker strategy to apply to all calls made by this service client (i.e. at the client level). + This client uses :py:data:`~oci.circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY` as default if no circuit breaker strategy is provided. + The specifics of circuit breaker strategy are described `here `__. + + :param function circuit_breaker_callback: (optional) + Callback function to receive any exceptions triggerred by the circuit breaker. + + :param bool client_level_realm_specific_endpoint_template_enabled: (optional) + A boolean flag to indicate whether or not this client should be created with realm specific endpoint template enabled or disable. By default, this will be set as None. + + :param allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this client should allow control characters in the response object. By default, the client will not + allow control characters to be in the response object. + """ + if not OCI_SDK_ENABLED_SERVICES_SET.is_service_enabled("delegate_access_control"): + raise InvalidAlloyConfig("The Alloy configuration has disabled this service, this behavior is controlled by OCI_SDK_ENABLED_SERVICES_SET variable. Please check if your local alloy-config file configured the service you're targeting or contact the cloud provider on the availability of this service") + + validate_config(config, signer=kwargs.get('signer')) + if 'signer' in kwargs: + signer = kwargs['signer'] + + elif AUTHENTICATION_TYPE_FIELD_NAME in config: + signer = get_signer_from_authentication_type(config) + + else: + signer = Signer( + tenancy=config["tenancy"], + user=config["user"], + fingerprint=config["fingerprint"], + private_key_file_location=config.get("key_file"), + pass_phrase=get_config_value_or_default(config, "pass_phrase"), + private_key_content=config.get("key_content") + ) + + base_client_init_kwargs = { + 'regional_client': True, + 'service_endpoint': kwargs.get('service_endpoint'), + 'base_path': '/20230801', + 'service_endpoint_template': 'https://delegate-access-control.{region}.oci.{secondLevelDomain}', + 'service_endpoint_template_per_realm': { }, # noqa: E201 E202 + 'skip_deserialization': kwargs.get('skip_deserialization', False), + 'circuit_breaker_strategy': kwargs.get('circuit_breaker_strategy', circuit_breaker.GLOBAL_CIRCUIT_BREAKER_STRATEGY), + 'client_level_realm_specific_endpoint_template_enabled': kwargs.get('client_level_realm_specific_endpoint_template_enabled') + } + if 'timeout' in kwargs: + base_client_init_kwargs['timeout'] = kwargs.get('timeout') + if base_client_init_kwargs.get('circuit_breaker_strategy') is None: + base_client_init_kwargs['circuit_breaker_strategy'] = circuit_breaker.DEFAULT_CIRCUIT_BREAKER_STRATEGY + if 'allow_control_chars' in kwargs: + base_client_init_kwargs['allow_control_chars'] = kwargs.get('allow_control_chars') + self.base_client = BaseClient("work_request", config, signer, delegate_access_control_type_mapping, **base_client_init_kwargs) + self.retry_strategy = kwargs.get('retry_strategy') + self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback') + + def get_work_request(self, work_request_id, **kwargs): + """ + Gets details of the work request with the given ID. + + + :param str work_request_id: (required) + The ID of the asynchronous request. + + :param str opc_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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.WorkRequest` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_work_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['workRequestId'] + resource_path = "/workRequests/{workRequestId}" + method = "GET" + operation_name = "get_work_request" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_work_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "workRequestId": work_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="WorkRequest", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="WorkRequest", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_work_request_errors(self, work_request_id, **kwargs): + """ + Returns a (paginated) list of errors for the work request with the given ID. + + + :param str work_request_id: (required) + The ID of the asynchronous request. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param int limit: (optional) + The maximum number of items to return. + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timestamp is descending. + + Allowed values are: "timestamp" + + :param str sort_order: (optional) + The sort order to use, either 'asc' or '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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.WorkRequestErrorCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_work_request_errors API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['workRequestId'] + resource_path = "/workRequests/{workRequestId}/errors" + method = "GET" + operation_name = "list_work_request_errors" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_request_id", + "page", + "limit", + "sort_by", + "sort_order" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_work_request_errors got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "workRequestId": work_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["timestamp"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + query_params = { + "page": kwargs.get("page", missing), + "limit": kwargs.get("limit", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="WorkRequestErrorCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="WorkRequestErrorCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_work_request_logs(self, work_request_id, **kwargs): + """ + Returns a (paginated) list of logs for the work request with the given ID. + + + :param str work_request_id: (required) + The ID of the asynchronous request. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param int limit: (optional) + The maximum number of items to return. + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timestamp is descending. + + Allowed values are: "timestamp" + + :param str sort_order: (optional) + The sort order to use, either 'asc' or '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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.WorkRequestLogEntryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_work_request_logs API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['workRequestId'] + resource_path = "/workRequests/{workRequestId}/logs" + method = "GET" + operation_name = "list_work_request_logs" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_request_id", + "page", + "limit", + "sort_by", + "sort_order" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_work_request_logs got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "workRequestId": work_request_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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["timestamp"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { 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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + query_params = { + "page": kwargs.get("page", missing), + "limit": kwargs.get("limit", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="WorkRequestLogEntryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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="WorkRequestLogEntryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def list_work_requests(self, compartment_id, **kwargs): + """ + Lists the work requests in a compartment. + + + :param str compartment_id: (required) + The `OCID`__ of the compartment. + + __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm + + :param str work_request_id: (optional) + The ID of the asynchronous work request. + + :param str status: (optional) + A filter to return only work requests with the given OperationStatus. + + Allowed values are: "ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED" + + :param str resource_id: (optional) + The ID of the resource affected by the work request. + + :param str opc_request_id: (optional) + The client request ID for tracing. + + :param str page: (optional) + The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call. + + :param int limit: (optional) + The maximum number of items to return. + + :param str sort_order: (optional) + The sort order to use, either 'asc' or 'desc'. + + Allowed values are: "ASC", "DESC" + + :param str sort_by: (optional) + The field to sort by. Only one sort order may be provided. Default order for timeAccepted is descending. + + Allowed values are: "timeAccepted" + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.delegate_access_control.models.WorkRequestSummaryCollection` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_work_requests API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['compartmentId'] + resource_path = "/workRequests" + method = "GET" + operation_name = "list_work_requests" + api_reference_link = "" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "work_request_id", + "status", + "resource_id", + "opc_request_id", + "page", + "limit", + "sort_order", + "sort_by" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_work_requests got unknown kwargs: {extra_kwargs!r}") + + if 'status' in kwargs: + status_allowed_values = ["ACCEPTED", "IN_PROGRESS", "WAITING", "NEEDS_ATTENTION", "FAILED", "SUCCEEDED", "CANCELING", "CANCELED"] + if kwargs['status'] not in status_allowed_values: + raise ValueError( + f"Invalid value for `status`, must be one of { status_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( + f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }" + ) + + if 'sort_by' in kwargs: + sort_by_allowed_values = ["timeAccepted"] + if kwargs['sort_by'] not in sort_by_allowed_values: + raise ValueError( + f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "workRequestId": kwargs.get("work_request_id", missing), + "status": kwargs.get("status", missing), + "resourceId": kwargs.get("resource_id", missing), + "page": kwargs.get("page", missing), + "limit": kwargs.get("limit", missing), + "sortOrder": kwargs.get("sort_order", missing), + "sortBy": kwargs.get("sort_by", 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="WorkRequestSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + query_params=query_params, + header_params=header_params, + response_type="WorkRequestSummaryCollection", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) diff --git a/src/oci/delegate_access_control/work_request_client_composite_operations.py b/src/oci/delegate_access_control/work_request_client_composite_operations.py new file mode 100644 index 0000000000..96028b2cd6 --- /dev/null +++ b/src/oci/delegate_access_control/work_request_client_composite_operations.py @@ -0,0 +1,26 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20230801 + +import oci # noqa: F401 +from oci.util import WAIT_RESOURCE_NOT_FOUND # noqa: F401 + + +class WorkRequestClientCompositeOperations(object): + """ + This class provides a wrapper around :py:class:`~oci.delegate_access_control.WorkRequestClient` and offers convenience methods + for operations that would otherwise need to be chained together. For example, instead of performing an action + on a resource (e.g. launching an instance, creating a load balancer) and then using a waiter to wait for the resource + to enter a given state, you can call a single method in this class to accomplish the same functionality + """ + + def __init__(self, client, **kwargs): + """ + Creates a new WorkRequestClientCompositeOperations object + + :param WorkRequestClient client: + The service client which will be wrapped by this object + """ + self.client = client diff --git a/src/oci/file_storage/file_storage_client.py b/src/oci/file_storage/file_storage_client.py index 96c731189e..1ba8ec8a36 100644 --- a/src/oci/file_storage/file_storage_client.py +++ b/src/oci/file_storage/file_storage_client.py @@ -117,6 +117,114 @@ def __init__(self, config, **kwargs): self.retry_strategy = kwargs.get('retry_strategy') self.circuit_breaker_callback = kwargs.get('circuit_breaker_callback') + def cancel_downgrade_shape_mount_target(self, mount_target_id, **kwargs): + """ + Cancel scheduled downgrade shape request for mount target. + + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ 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. + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.file_storage.models.MountTarget` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use cancel_downgrade_shape_mount_target API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['mountTargetId'] + resource_path = "/mountTargets/{mountTargetId}/actions/cancelShapeDowngrade" + method = "POST" + operation_name = "cancel_downgrade_shape_mount_target" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/filestorage/20171215/MountTarget/CancelDowngradeShapeMountTarget" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"cancel_downgrade_shape_mount_target got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "mountTargetId": mount_target_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def change_file_system_compartment(self, file_system_id, change_file_system_compartment_details, **kwargs): """ Moves a file system and its associated snapshots into a different compartment within the same tenancy. For information about moving resources between compartments, see `Moving Resources to a Different Compartment`__ @@ -3515,7 +3623,7 @@ def list_export_sets(self, compartment_id, availability_domain, **kwargs): :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -3700,7 +3808,7 @@ def list_exports(self, **kwargs): :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -3896,7 +4004,7 @@ def list_file_systems(self, compartment_id, availability_domain, **kwargs): :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -4108,7 +4216,7 @@ def list_filesystem_snapshot_policies(self, compartment_id, availability_domain, :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -4296,7 +4404,7 @@ def list_mount_targets(self, compartment_id, availability_domain, **kwargs): :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -4491,7 +4599,7 @@ def list_outbound_connectors(self, compartment_id, availability_domain, **kwargs :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -4679,7 +4787,7 @@ def list_replication_targets(self, compartment_id, availability_domain, **kwargs :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -4867,7 +4975,7 @@ def list_replications(self, compartment_id, availability_domain, **kwargs): :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call. - 1 is the minimum, 1000 is the maximum. + 1 is the minimum, 4096 is the maximum. For important details about how pagination works, see `List Pagination`__. @@ -5337,6 +5445,119 @@ def pause_filesystem_snapshot_policy(self, filesystem_snapshot_policy_id, **kwar api_reference_link=api_reference_link, required_arguments=required_arguments) + def schedule_downgrade_shape_mount_target(self, mount_target_id, schedule_downgrade_shape_mount_target_details, **kwargs): + """ + Schedule a downgrade shape of the mount target. + + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails schedule_downgrade_shape_mount_target_details: (required) + Details for changing the shape of mount target. + + :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. + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.file_storage.models.MountTarget` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use schedule_downgrade_shape_mount_target API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['mountTargetId'] + resource_path = "/mountTargets/{mountTargetId}/actions/scheduleShapeDowngrade" + method = "POST" + operation_name = "schedule_downgrade_shape_mount_target" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/filestorage/20171215/MountTarget/ScheduleDowngradeShapeMountTarget" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"schedule_downgrade_shape_mount_target got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "mountTargetId": mount_target_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=schedule_downgrade_shape_mount_target_details, + response_type="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=schedule_downgrade_shape_mount_target_details, + response_type="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def unpause_filesystem_snapshot_policy(self, filesystem_snapshot_policy_id, **kwargs): """ This operation unpauses a paused file system snapshot policy and updates the lifecycle state of the file system snapshot policy from @@ -6354,6 +6575,119 @@ def update_snapshot(self, snapshot_id, update_snapshot_details, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) + def upgrade_shape_mount_target(self, mount_target_id, upgrade_shape_mount_target_details, **kwargs): + """ + Upgrade shape request for mount target. + + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.file_storage.models.UpgradeShapeMountTargetDetails upgrade_shape_mount_target_details: (required) + Details for changing the shape of mount target. + + :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. + 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. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.file_storage.models.MountTarget` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use upgrade_shape_mount_target API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['mountTargetId'] + resource_path = "/mountTargets/{mountTargetId}/actions/upgradeShape" + method = "POST" + operation_name = "upgrade_shape_mount_target" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/filestorage/20171215/MountTarget/UpgradeShapeMountTarget" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"upgrade_shape_mount_target got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "mountTargetId": mount_target_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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} + + retry_strategy = self.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=upgrade_shape_mount_target_details, + response_type="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=upgrade_shape_mount_target_details, + response_type="MountTarget", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def validate_key_tabs(self, validate_key_tabs_details, **kwargs): """ Validates keytab contents for the secret details passed on the request or validte keytab contents associated with diff --git a/src/oci/file_storage/file_storage_client_composite_operations.py b/src/oci/file_storage/file_storage_client_composite_operations.py index cd5b78b868..148369ec7b 100644 --- a/src/oci/file_storage/file_storage_client_composite_operations.py +++ b/src/oci/file_storage/file_storage_client_composite_operations.py @@ -25,6 +25,50 @@ def __init__(self, client, **kwargs): """ self.client = client + def cancel_downgrade_shape_mount_target_and_wait_for_state(self, mount_target_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.file_storage.FileStorageClient.cancel_downgrade_shape_mount_target` and waits for the :py:class:`~oci.file_storage.models.MountTarget` acted upon + to enter the given state(s). + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ 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.file_storage.models.MountTarget.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.file_storage.FileStorageClient.cancel_downgrade_shape_mount_target` + + :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.cancel_downgrade_shape_mount_target(mount_target_id, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + mount_target_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_mount_target(mount_target_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def create_export_and_wait_for_state(self, create_export_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.file_storage.FileStorageClient.create_export` and waits for the :py:class:`~oci.file_storage.models.Export` acted upon @@ -851,6 +895,53 @@ def pause_filesystem_snapshot_policy_and_wait_for_state(self, filesystem_snapsho except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def schedule_downgrade_shape_mount_target_and_wait_for_state(self, mount_target_id, schedule_downgrade_shape_mount_target_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.file_storage.FileStorageClient.schedule_downgrade_shape_mount_target` and waits for the :py:class:`~oci.file_storage.models.MountTarget` acted upon + to enter the given state(s). + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.file_storage.models.ScheduleDowngradeShapeMountTargetDetails schedule_downgrade_shape_mount_target_details: (required) + Details for changing the shape of mount target. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.file_storage.models.MountTarget.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.file_storage.FileStorageClient.schedule_downgrade_shape_mount_target` + + :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.schedule_downgrade_shape_mount_target(mount_target_id, schedule_downgrade_shape_mount_target_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + mount_target_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_mount_target(mount_target_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def unpause_filesystem_snapshot_policy_and_wait_for_state(self, filesystem_snapshot_policy_id, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.file_storage.FileStorageClient.unpause_filesystem_snapshot_policy` and waits for the :py:class:`~oci.file_storage.models.FilesystemSnapshotPolicy` acted upon @@ -1270,3 +1361,50 @@ def update_snapshot_and_wait_for_state(self, snapshot_id, update_snapshot_detail raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def upgrade_shape_mount_target_and_wait_for_state(self, mount_target_id, upgrade_shape_mount_target_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.file_storage.FileStorageClient.upgrade_shape_mount_target` and waits for the :py:class:`~oci.file_storage.models.MountTarget` acted upon + to enter the given state(s). + + :param str mount_target_id: (required) + The `OCID`__ of the mount target. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + :param oci.file_storage.models.UpgradeShapeMountTargetDetails upgrade_shape_mount_target_details: (required) + Details for changing the shape of mount target. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.file_storage.models.MountTarget.lifecycle_state` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.file_storage.FileStorageClient.upgrade_shape_mount_target` + + :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.upgrade_shape_mount_target(mount_target_id, upgrade_shape_mount_target_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + mount_target_id = operation_result.data.id + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_mount_target(mount_target_id), # noqa: F821 + 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 (NameError, TypeError) as e: + if not e.args: + e.args = ('',) + e.args = e.args + ('This composite operation is currently not supported in the SDK. Please use the operation from the service client and use waiters as an alternative. For more information on waiters, visit: "https://docs.oracle.com/en-us/iaas/tools/python/latest/api/waiters.html"', ) + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + except Exception as e: + raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) diff --git a/src/oci/file_storage/models/__init__.py b/src/oci/file_storage/models/__init__.py index 0fbbcb18c5..8572768195 100644 --- a/src/oci/file_storage/models/__init__.py +++ b/src/oci/file_storage/models/__init__.py @@ -46,6 +46,7 @@ from .replication_summary import ReplicationSummary from .replication_target import ReplicationTarget from .replication_target_summary import ReplicationTargetSummary +from .schedule_downgrade_shape_mount_target_details import ScheduleDowngradeShapeMountTargetDetails from .snapshot import Snapshot from .snapshot_schedule import SnapshotSchedule from .snapshot_summary import SnapshotSummary @@ -60,6 +61,7 @@ from .update_outbound_connector_details import UpdateOutboundConnectorDetails from .update_replication_details import UpdateReplicationDetails from .update_snapshot_details import UpdateSnapshotDetails +from .upgrade_shape_mount_target_details import UpgradeShapeMountTargetDetails from .validate_key_tabs_details import ValidateKeyTabsDetails from .validate_key_tabs_response_details import ValidateKeyTabsResponseDetails @@ -105,6 +107,7 @@ "ReplicationSummary": ReplicationSummary, "ReplicationTarget": ReplicationTarget, "ReplicationTargetSummary": ReplicationTargetSummary, + "ScheduleDowngradeShapeMountTargetDetails": ScheduleDowngradeShapeMountTargetDetails, "Snapshot": Snapshot, "SnapshotSchedule": SnapshotSchedule, "SnapshotSummary": SnapshotSummary, @@ -119,6 +122,7 @@ "UpdateOutboundConnectorDetails": UpdateOutboundConnectorDetails, "UpdateReplicationDetails": UpdateReplicationDetails, "UpdateSnapshotDetails": UpdateSnapshotDetails, + "UpgradeShapeMountTargetDetails": UpgradeShapeMountTargetDetails, "ValidateKeyTabsDetails": ValidateKeyTabsDetails, "ValidateKeyTabsResponseDetails": ValidateKeyTabsResponseDetails } diff --git a/src/oci/file_storage/models/create_mount_target_details.py b/src/oci/file_storage/models/create_mount_target_details.py index 5848a10832..168edb144a 100644 --- a/src/oci/file_storage/models/create_mount_target_details.py +++ b/src/oci/file_storage/models/create_mount_target_details.py @@ -68,6 +68,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this CreateMountTargetDetails. :type defined_tags: dict(str, dict(str, object)) + :param requested_throughput: + The value to assign to the requested_throughput property of this CreateMountTargetDetails. + :type requested_throughput: int + """ self.swagger_types = { 'availability_domain': 'str', @@ -81,7 +85,8 @@ def __init__(self, **kwargs): 'nsg_ids': 'list[str]', 'kerberos': 'CreateKerberosDetails', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'requested_throughput': 'int' } self.attribute_map = { @@ -96,7 +101,8 @@ def __init__(self, **kwargs): 'nsg_ids': 'nsgIds', 'kerberos': 'kerberos', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'requested_throughput': 'requestedThroughput' } self._availability_domain = None @@ -111,6 +117,7 @@ def __init__(self, **kwargs): self._kerberos = None self._freeform_tags = None self._defined_tags = None + self._requested_throughput = None @property def availability_domain(self): @@ -282,20 +289,8 @@ def ip_address(self): the subnet's CIDR. If you don't specify a value, Oracle automatically assigns a private IP address from the subnet. - Note: This attribute value is stored in the `PrivateIp`__ resource, - not in the `mountTarget` resource. - To update the `ipAddress`, use `GetMountTarget` to obtain the - `OCIDs`__ of the mount target's - private IPs (`privateIpIds`). Then, you can use - `UpdatePrivateIp`__ - to update the `ipAddress` value. - Example: `10.0.3.3` - __ https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/20160918/PrivateIp/ - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - __ https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/20160918/PrivateIp/UpdatePrivateIp - :return: The ip_address of this CreateMountTargetDetails. :rtype: str @@ -310,20 +305,8 @@ def ip_address(self, ip_address): the subnet's CIDR. If you don't specify a value, Oracle automatically assigns a private IP address from the subnet. - Note: This attribute value is stored in the `PrivateIp`__ resource, - not in the `mountTarget` resource. - To update the `ipAddress`, use `GetMountTarget` to obtain the - `OCIDs`__ of the mount target's - private IPs (`privateIpIds`). Then, you can use - `UpdatePrivateIp`__ - to update the `ipAddress` value. - Example: `10.0.3.3` - __ https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/20160918/PrivateIp/ - __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm - __ https://docs.cloud.oracle.com/en-us/iaas/api/#/en/iaas/20160918/PrivateIp/UpdatePrivateIp - :param ip_address: The ip_address of this CreateMountTargetDetails. :type: str @@ -524,6 +507,36 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def requested_throughput(self): + """ + Gets the requested_throughput of this CreateMountTargetDetails. + Throughput for mount target in Gbps. Currently only 1 Gbps of requestedThroughput is supported during create MountTarget. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The requested_throughput of this CreateMountTargetDetails. + :rtype: int + """ + return self._requested_throughput + + @requested_throughput.setter + def requested_throughput(self, requested_throughput): + """ + Sets the requested_throughput of this CreateMountTargetDetails. + Throughput for mount target in Gbps. Currently only 1 Gbps of requestedThroughput is supported during create MountTarget. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param requested_throughput: The requested_throughput of this CreateMountTargetDetails. + :type: int + """ + self._requested_throughput = requested_throughput + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/file_storage/models/mount_target.py b/src/oci/file_storage/models/mount_target.py index 440514017c..c75b0b01be 100644 --- a/src/oci/file_storage/models/mount_target.py +++ b/src/oci/file_storage/models/mount_target.py @@ -37,6 +37,10 @@ class MountTarget(object): #: This constant has a value of "FAILED" LIFECYCLE_STATE_FAILED = "FAILED" + #: A constant which can be used with the lifecycle_state property of a MountTarget. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + #: A constant which can be used with the idmap_type property of a MountTarget. #: This constant has a value of "LDAP" IDMAP_TYPE_LDAP = "LDAP" @@ -76,7 +80,7 @@ def __init__(self, **kwargs): :param lifecycle_state: The value to assign to the lifecycle_state property of this MountTarget. - Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type lifecycle_state: str @@ -106,6 +110,22 @@ def __init__(self, **kwargs): The value to assign to the kerberos property of this MountTarget. :type kerberos: oci.file_storage.models.Kerberos + :param time_billing_cycle_end: + The value to assign to the time_billing_cycle_end property of this MountTarget. + :type time_billing_cycle_end: datetime + + :param observed_throughput: + The value to assign to the observed_throughput property of this MountTarget. + :type observed_throughput: int + + :param requested_throughput: + The value to assign to the requested_throughput property of this MountTarget. + :type requested_throughput: int + + :param reserved_storage_capacity: + The value to assign to the reserved_storage_capacity property of this MountTarget. + :type reserved_storage_capacity: int + :param time_created: The value to assign to the time_created property of this MountTarget. :type time_created: datetime @@ -133,6 +153,10 @@ def __init__(self, **kwargs): 'ldap_idmap': 'LdapIdmap', 'nsg_ids': 'list[str]', 'kerberos': 'Kerberos', + 'time_billing_cycle_end': 'datetime', + 'observed_throughput': 'int', + 'requested_throughput': 'int', + 'reserved_storage_capacity': 'int', 'time_created': 'datetime', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' @@ -152,6 +176,10 @@ def __init__(self, **kwargs): 'ldap_idmap': 'ldapIdmap', 'nsg_ids': 'nsgIds', 'kerberos': 'kerberos', + 'time_billing_cycle_end': 'timeBillingCycleEnd', + 'observed_throughput': 'observedThroughput', + 'requested_throughput': 'requestedThroughput', + 'reserved_storage_capacity': 'reservedStorageCapacity', 'time_created': 'timeCreated', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' @@ -170,6 +198,10 @@ def __init__(self, **kwargs): self._ldap_idmap = None self._nsg_ids = None self._kerberos = None + self._time_billing_cycle_end = None + self._observed_throughput = None + self._requested_throughput = None + self._reserved_storage_capacity = None self._time_created = None self._freeform_tags = None self._defined_tags = None @@ -352,7 +384,7 @@ def lifecycle_state(self): **[Required]** Gets the lifecycle_state of this MountTarget. The current state of the mount target. - Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -371,7 +403,7 @@ def lifecycle_state(self, lifecycle_state): :param lifecycle_state: The lifecycle_state of this MountTarget. :type: str """ - allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"] + allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING"] if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): lifecycle_state = 'UNKNOWN_ENUM_VALUE' self._lifecycle_state = lifecycle_state @@ -534,6 +566,124 @@ def kerberos(self, kerberos): """ self._kerberos = kerberos + @property + def time_billing_cycle_end(self): + """ + Gets the time_billing_cycle_end of this MountTarget. + The date and time the mount target current billing cycle will end and next one starts, expressed + in `RFC 3339`__ timestamp format. + + Example: `2016-08-25T21:10:29.600Z` + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_billing_cycle_end of this MountTarget. + :rtype: datetime + """ + return self._time_billing_cycle_end + + @time_billing_cycle_end.setter + def time_billing_cycle_end(self, time_billing_cycle_end): + """ + Sets the time_billing_cycle_end of this MountTarget. + The date and time the mount target current billing cycle will end and next one starts, expressed + in `RFC 3339`__ timestamp format. + + Example: `2016-08-25T21:10:29.600Z` + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_billing_cycle_end: The time_billing_cycle_end of this MountTarget. + :type: datetime + """ + self._time_billing_cycle_end = time_billing_cycle_end + + @property + def observed_throughput(self): + """ + Gets the observed_throughput of this MountTarget. + Current billed throughput for mount target in Gbps. This corresponds to shape of mount target. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The observed_throughput of this MountTarget. + :rtype: int + """ + return self._observed_throughput + + @observed_throughput.setter + def observed_throughput(self, observed_throughput): + """ + Sets the observed_throughput of this MountTarget. + Current billed throughput for mount target in Gbps. This corresponds to shape of mount target. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param observed_throughput: The observed_throughput of this MountTarget. + :type: int + """ + self._observed_throughput = observed_throughput + + @property + def requested_throughput(self): + """ + Gets the requested_throughput of this MountTarget. + - New throughput for mount target at the end of billing cycle in Gbps. + + + :return: The requested_throughput of this MountTarget. + :rtype: int + """ + return self._requested_throughput + + @requested_throughput.setter + def requested_throughput(self, requested_throughput): + """ + Sets the requested_throughput of this MountTarget. + - New throughput for mount target at the end of billing cycle in Gbps. + + + :param requested_throughput: The requested_throughput of this MountTarget. + :type: int + """ + self._requested_throughput = requested_throughput + + @property + def reserved_storage_capacity(self): + """ + Gets the reserved_storage_capacity of this MountTarget. + - Reserved capacity (GB) associated with this mount target. Reserved capacity depends on observedThroughput value + of mount target. Value is listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The reserved_storage_capacity of this MountTarget. + :rtype: int + """ + return self._reserved_storage_capacity + + @reserved_storage_capacity.setter + def reserved_storage_capacity(self, reserved_storage_capacity): + """ + Sets the reserved_storage_capacity of this MountTarget. + - Reserved capacity (GB) associated with this mount target. Reserved capacity depends on observedThroughput value + of mount target. Value is listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param reserved_storage_capacity: The reserved_storage_capacity of this MountTarget. + :type: int + """ + self._reserved_storage_capacity = reserved_storage_capacity + @property def time_created(self): """ diff --git a/src/oci/file_storage/models/mount_target_summary.py b/src/oci/file_storage/models/mount_target_summary.py index d16380ac35..10a923b01f 100644 --- a/src/oci/file_storage/models/mount_target_summary.py +++ b/src/oci/file_storage/models/mount_target_summary.py @@ -35,6 +35,10 @@ class MountTargetSummary(object): #: This constant has a value of "FAILED" LIFECYCLE_STATE_FAILED = "FAILED" + #: A constant which can be used with the lifecycle_state property of a MountTargetSummary. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + def __init__(self, **kwargs): """ Initializes a new MountTargetSummary object with values from keyword arguments. @@ -62,7 +66,7 @@ def __init__(self, **kwargs): :param lifecycle_state: The value to assign to the lifecycle_state property of this MountTargetSummary. - Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type lifecycle_state: str @@ -78,6 +82,22 @@ def __init__(self, **kwargs): The value to assign to the nsg_ids property of this MountTargetSummary. :type nsg_ids: list[str] + :param time_billing_cycle_end: + The value to assign to the time_billing_cycle_end property of this MountTargetSummary. + :type time_billing_cycle_end: datetime + + :param observed_throughput: + The value to assign to the observed_throughput property of this MountTargetSummary. + :type observed_throughput: int + + :param requested_throughput: + The value to assign to the requested_throughput property of this MountTargetSummary. + :type requested_throughput: int + + :param reserved_storage_capacity: + The value to assign to the reserved_storage_capacity property of this MountTargetSummary. + :type reserved_storage_capacity: int + :param time_created: The value to assign to the time_created property of this MountTargetSummary. :type time_created: datetime @@ -101,6 +121,10 @@ def __init__(self, **kwargs): 'private_ip_ids': 'list[str]', 'subnet_id': 'str', 'nsg_ids': 'list[str]', + 'time_billing_cycle_end': 'datetime', + 'observed_throughput': 'int', + 'requested_throughput': 'int', + 'reserved_storage_capacity': 'int', 'time_created': 'datetime', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' @@ -116,6 +140,10 @@ def __init__(self, **kwargs): 'private_ip_ids': 'privateIpIds', 'subnet_id': 'subnetId', 'nsg_ids': 'nsgIds', + 'time_billing_cycle_end': 'timeBillingCycleEnd', + 'observed_throughput': 'observedThroughput', + 'requested_throughput': 'requestedThroughput', + 'reserved_storage_capacity': 'reservedStorageCapacity', 'time_created': 'timeCreated', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' @@ -130,6 +158,10 @@ def __init__(self, **kwargs): self._private_ip_ids = None self._subnet_id = None self._nsg_ids = None + self._time_billing_cycle_end = None + self._observed_throughput = None + self._requested_throughput = None + self._reserved_storage_capacity = None self._time_created = None self._freeform_tags = None self._defined_tags = None @@ -288,7 +320,7 @@ def lifecycle_state(self): **[Required]** Gets the lifecycle_state of this MountTargetSummary. The current state of the mount target. - Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -307,7 +339,7 @@ def lifecycle_state(self, lifecycle_state): :param lifecycle_state: The lifecycle_state of this MountTargetSummary. :type: str """ - allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED"] + allowed_values = ["CREATING", "ACTIVE", "DELETING", "DELETED", "FAILED", "UPDATING"] if not value_allowed_none_or_none_sentinel(lifecycle_state, allowed_values): lifecycle_state = 'UNKNOWN_ENUM_VALUE' self._lifecycle_state = lifecycle_state @@ -400,6 +432,126 @@ def nsg_ids(self, nsg_ids): """ self._nsg_ids = nsg_ids + @property + def time_billing_cycle_end(self): + """ + Gets the time_billing_cycle_end of this MountTargetSummary. + The date and time the mount target current billing cycle will end, expressed in + `RFC 3339`__ timestamp format. Once a cycle ends, it is updated + automatically to next timestamp which is after 30 days. + + Example: `2016-08-25T21:10:29.600Z` + + __ https://tools.ietf.org/rfc/rfc3339 + + + :return: The time_billing_cycle_end of this MountTargetSummary. + :rtype: datetime + """ + return self._time_billing_cycle_end + + @time_billing_cycle_end.setter + def time_billing_cycle_end(self, time_billing_cycle_end): + """ + Sets the time_billing_cycle_end of this MountTargetSummary. + The date and time the mount target current billing cycle will end, expressed in + `RFC 3339`__ timestamp format. Once a cycle ends, it is updated + automatically to next timestamp which is after 30 days. + + Example: `2016-08-25T21:10:29.600Z` + + __ https://tools.ietf.org/rfc/rfc3339 + + + :param time_billing_cycle_end: The time_billing_cycle_end of this MountTargetSummary. + :type: datetime + """ + self._time_billing_cycle_end = time_billing_cycle_end + + @property + def observed_throughput(self): + """ + Gets the observed_throughput of this MountTargetSummary. + Current billed throughput for mount target in Gbps. This corresponds to shape of mount target. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The observed_throughput of this MountTargetSummary. + :rtype: int + """ + return self._observed_throughput + + @observed_throughput.setter + def observed_throughput(self, observed_throughput): + """ + Sets the observed_throughput of this MountTargetSummary. + Current billed throughput for mount target in Gbps. This corresponds to shape of mount target. + Available shapes and corresponding throughput are listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param observed_throughput: The observed_throughput of this MountTargetSummary. + :type: int + """ + self._observed_throughput = observed_throughput + + @property + def requested_throughput(self): + """ + Gets the requested_throughput of this MountTargetSummary. + - New throughput for mount target at the end of billing cycle in Gbps. + + + :return: The requested_throughput of this MountTargetSummary. + :rtype: int + """ + return self._requested_throughput + + @requested_throughput.setter + def requested_throughput(self, requested_throughput): + """ + Sets the requested_throughput of this MountTargetSummary. + - New throughput for mount target at the end of billing cycle in Gbps. + + + :param requested_throughput: The requested_throughput of this MountTargetSummary. + :type: int + """ + self._requested_throughput = requested_throughput + + @property + def reserved_storage_capacity(self): + """ + Gets the reserved_storage_capacity of this MountTargetSummary. + - Reserved capacity (GB) associated with this mount target. Reserved capacity depends on observedThroughput value + of mount target. Value is listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The reserved_storage_capacity of this MountTargetSummary. + :rtype: int + """ + return self._reserved_storage_capacity + + @reserved_storage_capacity.setter + def reserved_storage_capacity(self, reserved_storage_capacity): + """ + Sets the reserved_storage_capacity of this MountTargetSummary. + - Reserved capacity (GB) associated with this mount target. Reserved capacity depends on observedThroughput value + of mount target. Value is listed at `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param reserved_storage_capacity: The reserved_storage_capacity of this MountTargetSummary. + :type: int + """ + self._reserved_storage_capacity = reserved_storage_capacity + @property def time_created(self): """ diff --git a/src/oci/file_storage/models/schedule_downgrade_shape_mount_target_details.py b/src/oci/file_storage/models/schedule_downgrade_shape_mount_target_details.py new file mode 100644 index 0000000000..d65b6a7687 --- /dev/null +++ b/src/oci/file_storage/models/schedule_downgrade_shape_mount_target_details.py @@ -0,0 +1,78 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20171215 + + +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 ScheduleDowngradeShapeMountTargetDetails(object): + """ + Shape details about the Mount Target. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ScheduleDowngradeShapeMountTargetDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param requested_throughput: + The value to assign to the requested_throughput property of this ScheduleDowngradeShapeMountTargetDetails. + :type requested_throughput: int + + """ + self.swagger_types = { + 'requested_throughput': 'int' + } + + self.attribute_map = { + 'requested_throughput': 'requestedThroughput' + } + + self._requested_throughput = None + + @property + def requested_throughput(self): + """ + Gets the requested_throughput of this ScheduleDowngradeShapeMountTargetDetails. + New throughput for mount target in Gbps. Available shapes and corresponding throughput are listed at + `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The requested_throughput of this ScheduleDowngradeShapeMountTargetDetails. + :rtype: int + """ + return self._requested_throughput + + @requested_throughput.setter + def requested_throughput(self, requested_throughput): + """ + Sets the requested_throughput of this ScheduleDowngradeShapeMountTargetDetails. + New throughput for mount target in Gbps. Available shapes and corresponding throughput are listed at + `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param requested_throughput: The requested_throughput of this ScheduleDowngradeShapeMountTargetDetails. + :type: int + """ + self._requested_throughput = requested_throughput + + 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/file_storage/models/upgrade_shape_mount_target_details.py b/src/oci/file_storage/models/upgrade_shape_mount_target_details.py new file mode 100644 index 0000000000..6106a120b9 --- /dev/null +++ b/src/oci/file_storage/models/upgrade_shape_mount_target_details.py @@ -0,0 +1,78 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20171215 + + +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 UpgradeShapeMountTargetDetails(object): + """ + Shape details about the Mount Target. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpgradeShapeMountTargetDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param requested_throughput: + The value to assign to the requested_throughput property of this UpgradeShapeMountTargetDetails. + :type requested_throughput: int + + """ + self.swagger_types = { + 'requested_throughput': 'int' + } + + self.attribute_map = { + 'requested_throughput': 'requestedThroughput' + } + + self._requested_throughput = None + + @property + def requested_throughput(self): + """ + Gets the requested_throughput of this UpgradeShapeMountTargetDetails. + New throughput for mount target in Gbps. Available shapes and corresponding throughput are listed at + `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :return: The requested_throughput of this UpgradeShapeMountTargetDetails. + :rtype: int + """ + return self._requested_throughput + + @requested_throughput.setter + def requested_throughput(self, requested_throughput): + """ + Sets the requested_throughput of this UpgradeShapeMountTargetDetails. + New throughput for mount target in Gbps. Available shapes and corresponding throughput are listed at + `Mount Target Performance`__. + + __ https://docs.oracle.com/iaas/Content/File/Tasks/managingmounttargets.htm#performance + + + :param requested_throughput: The requested_throughput of this UpgradeShapeMountTargetDetails. + :type: int + """ + self._requested_throughput = requested_throughput + + 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/fusion_apps/models/fusion_environment_family.py b/src/oci/fusion_apps/models/fusion_environment_family.py index fc3eeba620..62a9b6c999 100644 --- a/src/oci/fusion_apps/models/fusion_environment_family.py +++ b/src/oci/fusion_apps/models/fusion_environment_family.py @@ -96,6 +96,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this FusionEnvironmentFamily. :type defined_tags: dict(str, dict(str, object)) + :param time_last_subscription_update: + The value to assign to the time_last_subscription_update property of this FusionEnvironmentFamily. + :type time_last_subscription_update: datetime + """ self.swagger_types = { 'id': 'str', @@ -109,7 +113,8 @@ def __init__(self, **kwargs): 'lifecycle_details': 'str', 'system_name': 'str', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'time_last_subscription_update': 'datetime' } self.attribute_map = { @@ -124,7 +129,8 @@ def __init__(self, **kwargs): 'lifecycle_details': 'lifecycleDetails', 'system_name': 'systemName', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'time_last_subscription_update': 'timeLastSubscriptionUpdate' } self._id = None @@ -139,6 +145,7 @@ def __init__(self, **kwargs): self._system_name = None self._freeform_tags = None self._defined_tags = None + self._time_last_subscription_update = None @property def id(self): @@ -434,6 +441,30 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def time_last_subscription_update(self): + """ + Gets the time_last_subscription_update of this FusionEnvironmentFamily. + Indicates when the family received the last subscription update + + + :return: The time_last_subscription_update of this FusionEnvironmentFamily. + :rtype: datetime + """ + return self._time_last_subscription_update + + @time_last_subscription_update.setter + def time_last_subscription_update(self, time_last_subscription_update): + """ + Sets the time_last_subscription_update of this FusionEnvironmentFamily. + Indicates when the family received the last subscription update + + + :param time_last_subscription_update: The time_last_subscription_update of this FusionEnvironmentFamily. + :type: datetime + """ + self._time_last_subscription_update = time_last_subscription_update + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/key_management/kms_hsm_cluster_client.py b/src/oci/key_management/kms_hsm_cluster_client.py index 82e48bbd7e..f6418b75ef 100644 --- a/src/oci/key_management/kms_hsm_cluster_client.py +++ b/src/oci/key_management/kms_hsm_cluster_client.py @@ -122,7 +122,7 @@ def cancel_hsm_cluster_deletion(self, hsm_cluster_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param str if_match: (optional) For optimistic concurrency control. In the PUT or DELETE call for a @@ -240,7 +240,7 @@ def change_hsm_cluster_compartment(self, hsm_cluster_id, change_hsm_cluster_comp :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.ChangeHsmClusterCompartmentDetails change_hsm_cluster_compartment_details: (required) Details of change HSM Cluster compartment. @@ -460,7 +460,7 @@ def download_certificate_signing_request(self, hsm_cluster_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param str opc_request_id: (optional) Unique identifier for the request. If provided, the returned request ID @@ -583,7 +583,7 @@ def get_hsm_cluster(self, hsm_cluster_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param str opc_request_id: (optional) Unique identifier for the request. If provided, the returned request ID @@ -681,10 +681,10 @@ def get_hsm_partition(self, hsm_cluster_id, hsm_partition_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param str hsm_partition_id: (required) - The OCID of the HSM Partition. + The OCID of the HSM Partition. This is a unique identifier which each hsmPartition will have. :param str opc_request_id: (optional) Unique identifier for the request. If provided, the returned request ID @@ -794,7 +794,7 @@ def get_pre_co_user_credentials(self, hsm_cluster_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param str opc_request_id: (optional) Unique identifier for the request. If provided, the returned request ID @@ -1042,7 +1042,7 @@ def list_hsm_partitions(self, hsm_cluster_id, **kwargs): :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param int limit: (optional) The maximum number of items to return in a paginated \"List\" call. @@ -1071,7 +1071,7 @@ def list_hsm_partitions(self, hsm_cluster_id, **kwargs): :param str lifecycle_state: (optional) A filter that returns only resources that match the specified lifecycle state. The state value is case-insensitive. - Allowed values are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED" + Allowed values are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", "SCHEDULING_DELETION", "PENDING_DELETION", "DELETING", "DELETED" :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. @@ -1139,7 +1139,7 @@ def list_hsm_partitions(self, hsm_cluster_id, **kwargs): ) if 'lifecycle_state' in kwargs: - lifecycle_state_allowed_values = ["ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED"] + lifecycle_state_allowed_values = ["ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", "SCHEDULING_DELETION", "PENDING_DELETION", "DELETING", "DELETED"] if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: raise ValueError( f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" @@ -1202,7 +1202,7 @@ def schedule_hsm_cluster_deletion(self, hsm_cluster_id, schedule_hsm_cluster_del :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.ScheduleHsmClusterDeletionDetails schedule_hsm_cluster_deletion_details: (required) Details of ScheduleHsmClusterDeletionDetails @@ -1330,7 +1330,7 @@ def update_hsm_cluster(self, hsm_cluster_id, update_hsm_cluster_details, **kwarg :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.UpdateHsmClusterDetails update_hsm_cluster_details: (required) Details of the HsmCluster Resource @@ -1442,7 +1442,7 @@ def upload_partition_certificates(self, hsm_cluster_id, upload_partition_certifi :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.UploadPartitionCertificatesDetails upload_partition_certificates_details: (required) To upload partition certificates. diff --git a/src/oci/key_management/kms_hsm_cluster_client_composite_operations.py b/src/oci/key_management/kms_hsm_cluster_client_composite_operations.py index 96e6c3b1e4..aa7cd92192 100644 --- a/src/oci/key_management/kms_hsm_cluster_client_composite_operations.py +++ b/src/oci/key_management/kms_hsm_cluster_client_composite_operations.py @@ -31,7 +31,7 @@ def cancel_hsm_cluster_deletion_and_wait_for_state(self, hsm_cluster_id, wait_fo to enter the given state(s). :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param list[str] wait_for_states: An array of states to wait on. These should be valid values for :py:attr:`~oci.key_management.models.HsmCluster.lifecycle_state` @@ -115,7 +115,7 @@ def schedule_hsm_cluster_deletion_and_wait_for_state(self, hsm_cluster_id, sched to enter the given state(s). :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.ScheduleHsmClusterDeletionDetails schedule_hsm_cluster_deletion_details: (required) Details of ScheduleHsmClusterDeletionDetails @@ -160,7 +160,7 @@ def update_hsm_cluster_and_wait_for_state(self, hsm_cluster_id, update_hsm_clust to enter the given state(s). :param str hsm_cluster_id: (required) - The OCID of the HSM Cluster. + The OCID of the HSM Cluster. This is a unique identifier assigned to each hsmCluster. :param oci.key_management.models.UpdateHsmClusterDetails update_hsm_cluster_details: (required) Details of the HsmCluster Resource diff --git a/src/oci/key_management/models/auto_key_rotation_details.py b/src/oci/key_management/models/auto_key_rotation_details.py index 2e11f53fd3..463e75fd58 100644 --- a/src/oci/key_management/models/auto_key_rotation_details.py +++ b/src/oci/key_management/models/auto_key_rotation_details.py @@ -88,7 +88,7 @@ def __init__(self, **kwargs): def rotation_interval_in_days(self): """ Gets the rotation_interval_in_days of this AutoKeyRotationDetails. - The interval of auto key rotation. For auto key rotation the interval should between 30 day and 365 days (1 year) + The interval of auto key rotation. For auto key rotation the interval should between 60 day and 365 days (1 year). Note: User must specify this parameter when creating a new schedule. :return: The rotation_interval_in_days of this AutoKeyRotationDetails. @@ -100,7 +100,7 @@ def rotation_interval_in_days(self): def rotation_interval_in_days(self, rotation_interval_in_days): """ Sets the rotation_interval_in_days of this AutoKeyRotationDetails. - The interval of auto key rotation. For auto key rotation the interval should between 30 day and 365 days (1 year) + The interval of auto key rotation. For auto key rotation the interval should between 60 day and 365 days (1 year). Note: User must specify this parameter when creating a new schedule. :param rotation_interval_in_days: The rotation_interval_in_days of this AutoKeyRotationDetails. @@ -112,7 +112,7 @@ def rotation_interval_in_days(self, rotation_interval_in_days): def time_of_schedule_start(self): """ Gets the time_of_schedule_start of this AutoKeyRotationDetails. - A property indicating scheduled start date expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z` . + A property indicating scheduled start date expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z. The time has no significance when scheduling an auto key rotation as this can be done anytime approximately the scheduled day, KMS ignores the time and replaces it with 00:00, for example 2023-04-04T15:14:13Z will be used as 2023-04-04T00:00:00Z . Note : Today\u2019s date will be used if not specified by customer. :return: The time_of_schedule_start of this AutoKeyRotationDetails. @@ -124,7 +124,7 @@ def time_of_schedule_start(self): def time_of_schedule_start(self, time_of_schedule_start): """ Sets the time_of_schedule_start of this AutoKeyRotationDetails. - A property indicating scheduled start date expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z` . + A property indicating scheduled start date expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z. The time has no significance when scheduling an auto key rotation as this can be done anytime approximately the scheduled day, KMS ignores the time and replaces it with 00:00, for example 2023-04-04T15:14:13Z will be used as 2023-04-04T00:00:00Z . Note : Today\u2019s date will be used if not specified by customer. :param time_of_schedule_start: The time_of_schedule_start of this AutoKeyRotationDetails. @@ -136,7 +136,7 @@ def time_of_schedule_start(self, time_of_schedule_start): def time_of_next_rotation(self): """ Gets the time_of_next_rotation of this AutoKeyRotationDetails. - A property indicating Next estimated scheduled Time, as per the interval, expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z` . + A property indicating Next estimated scheduled Time, as per the interval, expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z`. The time has no significance when scheduling an auto key rotation as this can be done anytime approximately the scheduled day, KMS ignores the time and replaces it with 00:00, for example 2023-04-04T15:14:13Z will be used as 2023-04-04T00:00:00Z. :return: The time_of_next_rotation of this AutoKeyRotationDetails. @@ -148,7 +148,7 @@ def time_of_next_rotation(self): def time_of_next_rotation(self, time_of_next_rotation): """ Sets the time_of_next_rotation of this AutoKeyRotationDetails. - A property indicating Next estimated scheduled Time, as per the interval, expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z` . + A property indicating Next estimated scheduled Time, as per the interval, expressed as date YYYY-MM-DD String. Example: `2023-04-04T00:00:00Z`. The time has no significance when scheduling an auto key rotation as this can be done anytime approximately the scheduled day, KMS ignores the time and replaces it with 00:00, for example 2023-04-04T15:14:13Z will be used as 2023-04-04T00:00:00Z. :param time_of_next_rotation: The time_of_next_rotation of this AutoKeyRotationDetails. @@ -160,7 +160,7 @@ def time_of_next_rotation(self, time_of_next_rotation): def time_of_last_rotation(self): """ Gets the time_of_last_rotation of this AutoKeyRotationDetails. - A property indicating Last rotation Date Example: `2023-04-04T00:00:00Z`. + A property indicating Last rotation Date. Example: `2023-04-04T00:00:00Z`. :return: The time_of_last_rotation of this AutoKeyRotationDetails. @@ -172,7 +172,7 @@ def time_of_last_rotation(self): def time_of_last_rotation(self, time_of_last_rotation): """ Sets the time_of_last_rotation of this AutoKeyRotationDetails. - A property indicating Last rotation Date Example: `2023-04-04T00:00:00Z`. + A property indicating Last rotation Date. Example: `2023-04-04T00:00:00Z`. :param time_of_last_rotation: The time_of_last_rotation of this AutoKeyRotationDetails. @@ -214,7 +214,7 @@ def last_rotation_status(self, last_rotation_status): def last_rotation_message(self): """ Gets the last_rotation_message of this AutoKeyRotationDetails. - The last execution status message. + The last execution status message of auto key rotation. :return: The last_rotation_message of this AutoKeyRotationDetails. @@ -226,7 +226,7 @@ def last_rotation_message(self): def last_rotation_message(self, last_rotation_message): """ Sets the last_rotation_message of this AutoKeyRotationDetails. - The last execution status message. + The last execution status message of auto key rotation. :param last_rotation_message: The last_rotation_message of this AutoKeyRotationDetails. diff --git a/src/oci/key_management/models/change_hsm_cluster_compartment_details.py b/src/oci/key_management/models/change_hsm_cluster_compartment_details.py index 8643272736..310550ebe8 100644 --- a/src/oci/key_management/models/change_hsm_cluster_compartment_details.py +++ b/src/oci/key_management/models/change_hsm_cluster_compartment_details.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class ChangeHsmClusterCompartmentDetails(object): """ - The details of the compartment you wish to move the Hsm. + The details of the compartment you wish to move the hsm cluster to. """ def __init__(self, **kwargs): @@ -39,7 +39,7 @@ def __init__(self, **kwargs): def compartment_id(self): """ **[Required]** Gets the compartment_id of this ChangeHsmClusterCompartmentDetails. - The [OCID] of the compartment to move the hsm to. + The [OCID] of the compartment to move the hsm cluster to. :return: The compartment_id of this ChangeHsmClusterCompartmentDetails. @@ -51,7 +51,7 @@ def compartment_id(self): def compartment_id(self, compartment_id): """ Sets the compartment_id of this ChangeHsmClusterCompartmentDetails. - The [OCID] of the compartment to move the hsm to. + The [OCID] of the compartment to move the hsm cluster to. :param compartment_id: The compartment_id of this ChangeHsmClusterCompartmentDetails. diff --git a/src/oci/key_management/models/create_hsm_cluster_details.py b/src/oci/key_management/models/create_hsm_cluster_details.py index d1f0e749e2..19b5be2c3c 100644 --- a/src/oci/key_management/models/create_hsm_cluster_details.py +++ b/src/oci/key_management/models/create_hsm_cluster_details.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class CreateHsmClusterDetails(object): """ - The details of the HSM resource that you want to create. + The details of the HSM cluster resource that you want to create. """ def __init__(self, **kwargs): @@ -60,7 +60,7 @@ def __init__(self, **kwargs): def compartment_id(self): """ **[Required]** Gets the compartment_id of this CreateHsmClusterDetails. - The OCID of the compartment where you want to create this HSM resource. + The OCID of the compartment where you want to create this HSM cluster resource. :return: The compartment_id of this CreateHsmClusterDetails. @@ -72,7 +72,7 @@ def compartment_id(self): def compartment_id(self, compartment_id): """ Sets the compartment_id of this CreateHsmClusterDetails. - The OCID of the compartment where you want to create this HSM resource. + The OCID of the compartment where you want to create this HSM cluster resource. :param compartment_id: The compartment_id of this CreateHsmClusterDetails. @@ -84,7 +84,7 @@ def compartment_id(self, compartment_id): def display_name(self): """ **[Required]** Gets the display_name of this CreateHsmClusterDetails. - A user-friendly name for the HSM resource. It does not have to be unique, and it is changeable. + A user-friendly display name for the HSM cluster resource. It does not have to be unique, and it is changeable. Avoid entering confidential information. @@ -97,7 +97,7 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this CreateHsmClusterDetails. - A user-friendly name for the HSM resource. It does not have to be unique, and it is changeable. + A user-friendly display name for the HSM cluster resource. It does not have to be unique, and it is changeable. Avoid entering confidential information. diff --git a/src/oci/key_management/models/hsm_cluster.py b/src/oci/key_management/models/hsm_cluster.py index 05637750c0..9d5b0f0740 100644 --- a/src/oci/key_management/models/hsm_cluster.py +++ b/src/oci/key_management/models/hsm_cluster.py @@ -196,7 +196,7 @@ def compartment_id(self, compartment_id): def display_name(self): """ **[Required]** Gets the display_name of this HsmCluster. - A user-friendly name for the HSMCluster resource. It does not have to be unique, and it is changeable. + A user-friendly display name for the HSMCluster resource. It does not have to be unique, and it is changeable. Avoid entering confidential information. @@ -209,7 +209,7 @@ def display_name(self): def display_name(self, display_name): """ Sets the display_name of this HsmCluster. - A user-friendly name for the HSMCluster resource. It does not have to be unique, and it is changeable. + A user-friendly display name for the HSMCluster resource. It does not have to be unique, and it is changeable. Avoid entering confidential information. @@ -320,7 +320,7 @@ def lifecycle_state(self, lifecycle_state): def dns_name(self): """ **[Required]** Gets the dns_name of this HsmCluster. - DNS name for the Hsm Cluster. + DNS name for the HSM Cluster -- this will contain information about the region as well. :return: The dns_name of this HsmCluster. @@ -332,7 +332,7 @@ def dns_name(self): def dns_name(self, dns_name): """ Sets the dns_name of this HsmCluster. - DNS name for the Hsm Cluster. + DNS name for the HSM Cluster -- this will contain information about the region as well. :param dns_name: The dns_name of this HsmCluster. diff --git a/src/oci/key_management/models/hsm_cluster_collection.py b/src/oci/key_management/models/hsm_cluster_collection.py index 760d3eec4b..60329d41ee 100644 --- a/src/oci/key_management/models/hsm_cluster_collection.py +++ b/src/oci/key_management/models/hsm_cluster_collection.py @@ -39,7 +39,7 @@ def __init__(self, **kwargs): def items(self): """ **[Required]** Gets the items of this HsmClusterCollection. - List of Hsm Clusters. + List of HSM Cluster Summary Objects. :return: The items of this HsmClusterCollection. @@ -51,7 +51,7 @@ def items(self): def items(self, items): """ Sets the items of this HsmClusterCollection. - List of Hsm Clusters. + List of HSM Cluster Summary Objects. :param items: The items of this HsmClusterCollection. diff --git a/src/oci/key_management/models/hsm_cluster_summary.py b/src/oci/key_management/models/hsm_cluster_summary.py index fb5e11f5e6..a35c58f844 100644 --- a/src/oci/key_management/models/hsm_cluster_summary.py +++ b/src/oci/key_management/models/hsm_cluster_summary.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class HsmClusterSummary(object): """ - The details of the HSM resource. + An object which encapsulates the details of a given HSM Cluster. """ def __init__(self, **kwargs): @@ -204,7 +204,7 @@ def lifecycle_state(self, lifecycle_state): def dns_name(self): """ **[Required]** Gets the dns_name of this HsmClusterSummary. - DNS name for the HSMCluster. + DNS name for the HSMCluster -- this will contain information about the region as well. :return: The dns_name of this HsmClusterSummary. @@ -216,7 +216,7 @@ def dns_name(self): def dns_name(self, dns_name): """ Sets the dns_name of this HsmClusterSummary. - DNS name for the HSMCluster. + DNS name for the HSMCluster -- this will contain information about the region as well. :param dns_name: The dns_name of this HsmClusterSummary. diff --git a/src/oci/key_management/models/hsm_partition.py b/src/oci/key_management/models/hsm_partition.py index cb957e18f5..2d660ca3bd 100644 --- a/src/oci/key_management/models/hsm_partition.py +++ b/src/oci/key_management/models/hsm_partition.py @@ -31,6 +31,22 @@ class HsmPartition(object): #: This constant has a value of "ACTIVATION_REQUIRED" LIFECYCLE_STATE_ACTIVATION_REQUIRED = "ACTIVATION_REQUIRED" + #: A constant which can be used with the lifecycle_state property of a HsmPartition. + #: This constant has a value of "SCHEDULING_DELETION" + LIFECYCLE_STATE_SCHEDULING_DELETION = "SCHEDULING_DELETION" + + #: A constant which can be used with the lifecycle_state property of a HsmPartition. + #: This constant has a value of "PENDING_DELETION" + LIFECYCLE_STATE_PENDING_DELETION = "PENDING_DELETION" + + #: A constant which can be used with the lifecycle_state property of a HsmPartition. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a HsmPartition. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + def __init__(self, **kwargs): """ Initializes a new HsmPartition object with values from keyword arguments. @@ -58,7 +74,7 @@ def __init__(self, **kwargs): :param lifecycle_state: The value to assign to the lifecycle_state property of this HsmPartition. - Allowed values for this property are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", "SCHEDULING_DELETION", "PENDING_DELETION", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type lifecycle_state: str @@ -92,7 +108,7 @@ def __init__(self, **kwargs): def id(self): """ **[Required]** Gets the id of this HsmPartition. - The OCID of the HSM resource. + The OCID of the HSM resource. Each HSM resource has a unique OCID as an identifier. :return: The id of this HsmPartition. @@ -104,7 +120,7 @@ def id(self): def id(self, id): """ Sets the id of this HsmPartition. - The OCID of the HSM resource. + The OCID of the HSM resource. Each HSM resource has a unique OCID as an identifier. :param id: The id of this HsmPartition. @@ -140,7 +156,7 @@ def compartment_id(self, compartment_id): def port_information(self): """ **[Required]** Gets the port_information of this HsmPartition. - Details of PortNumber and PortType. + Details of a single portInformation item include the PortNumber (an integer used as an identifier) and the PortType (refers to either an enum value of Managementutility,Clientutility, or null) :return: The port_information of this HsmPartition. @@ -152,7 +168,7 @@ def port_information(self): def port_information(self, port_information): """ Sets the port_information of this HsmPartition. - Details of PortNumber and PortType. + Details of a single portInformation item include the PortNumber (an integer used as an identifier) and the PortType (refers to either an enum value of Managementutility,Clientutility, or null) :param port_information: The port_information of this HsmPartition. @@ -228,9 +244,11 @@ def time_updated(self, time_updated): def lifecycle_state(self): """ **[Required]** Gets the lifecycle_state of this HsmPartition. - The HSMPartition's current lifecycle state. + A HSMCluster resource's current lifecycle state. - Allowed values for this property are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", 'UNKNOWN_ENUM_VALUE'. + Example: `ACTIVE` + + Allowed values for this property are: "ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", "SCHEDULING_DELETION", "PENDING_DELETION", "DELETING", "DELETED", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -243,13 +261,15 @@ def lifecycle_state(self): def lifecycle_state(self, lifecycle_state): """ Sets the lifecycle_state of this HsmPartition. - The HSMPartition's current lifecycle state. + A HSMCluster resource's current lifecycle state. + + Example: `ACTIVE` :param lifecycle_state: The lifecycle_state of this HsmPartition. :type: str """ - allowed_values = ["ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED"] + allowed_values = ["ACTIVE", "INACTIVE", "ACTIVATING", "ACTIVATION_REQUIRED", "SCHEDULING_DELETION", "PENDING_DELETION", "DELETING", "DELETED"] 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/key_management/models/hsm_partition_collection.py b/src/oci/key_management/models/hsm_partition_collection.py index fc0c45ac91..7d3676929a 100644 --- a/src/oci/key_management/models/hsm_partition_collection.py +++ b/src/oci/key_management/models/hsm_partition_collection.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class HsmPartitionCollection(object): """ - HsmPartitionCollection object with page of HsmPartitionSummary objects. + HsmPartitionCollection object with page of HsmPartitionSummary objects. A HsmPartitionSummary object contains details about the corresponding HSM. """ def __init__(self, **kwargs): diff --git a/src/oci/key_management/models/hsm_partition_summary.py b/src/oci/key_management/models/hsm_partition_summary.py index 65f7bd1ea7..1408c44e0f 100644 --- a/src/oci/key_management/models/hsm_partition_summary.py +++ b/src/oci/key_management/models/hsm_partition_summary.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class HsmPartitionSummary(object): """ - The details of the Hsm. + An object which encapsulates the details of a given HSM. """ def __init__(self, **kwargs): @@ -81,7 +81,7 @@ def __init__(self, **kwargs): def id(self): """ **[Required]** Gets the id of this HsmPartitionSummary. - The OCID of the HSM resource. + The OCID of the HSM resource. Each HSM resource will have a unique OCID identifier. :return: The id of this HsmPartitionSummary. @@ -93,7 +93,7 @@ def id(self): def id(self, id): """ Sets the id of this HsmPartitionSummary. - The OCID of the HSM resource. + The OCID of the HSM resource. Each HSM resource will have a unique OCID identifier. :param id: The id of this HsmPartitionSummary. @@ -129,7 +129,9 @@ def hsm_cluster_id(self, hsm_cluster_id): def lifecycle_state(self): """ **[Required]** Gets the lifecycle_state of this HsmPartitionSummary. - The Hsm's current lifecycle state. + A HSMCluster resource's current lifecycle state. + + Example: `ACTIVE` :return: The lifecycle_state of this HsmPartitionSummary. @@ -141,7 +143,9 @@ def lifecycle_state(self): def lifecycle_state(self, lifecycle_state): """ Sets the lifecycle_state of this HsmPartitionSummary. - The Hsm's current lifecycle state. + A HSMCluster resource's current lifecycle state. + + Example: `ACTIVE` :param lifecycle_state: The lifecycle_state of this HsmPartitionSummary. @@ -177,7 +181,7 @@ def compartment_id(self, compartment_id): def port_information(self): """ **[Required]** Gets the port_information of this HsmPartitionSummary. - Port summary. + Details of a single portInformation item include the PortNumber (an integer used as an identifier) and the PortType (refers to either an enum value of Managementutility,Clientutility, or null) :return: The port_information of this HsmPartitionSummary. @@ -189,7 +193,7 @@ def port_information(self): def port_information(self, port_information): """ Sets the port_information of this HsmPartitionSummary. - Port summary. + Details of a single portInformation item include the PortNumber (an integer used as an identifier) and the PortType (refers to either an enum value of Managementutility,Clientutility, or null) :param port_information: The port_information of this HsmPartitionSummary. diff --git a/src/oci/key_management/models/port_information.py b/src/oci/key_management/models/port_information.py index 209ecf81b9..cc1998c0ea 100644 --- a/src/oci/key_management/models/port_information.py +++ b/src/oci/key_management/models/port_information.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class PortInformation(object): """ - The details of the port. + Details of a single portInformation item include the PortNumber (an integer used as an identifier) and the PortType (this refers to either an enum value of Management Utility, Client Utility, or null) """ #: A constant which can be used with the port_type property of a PortInformation. @@ -56,7 +56,7 @@ def __init__(self, **kwargs): def port_number(self): """ **[Required]** Gets the port_number of this PortInformation. - The port number of the cavium server. + The port number is a unique identifier which is typically used as the loadbalancer listener. :return: The port_number of this PortInformation. @@ -68,7 +68,7 @@ def port_number(self): def port_number(self, port_number): """ Sets the port_number of this PortInformation. - The port number of the cavium server. + The port number is a unique identifier which is typically used as the loadbalancer listener. :param port_number: The port_number of this PortInformation. @@ -80,7 +80,7 @@ def port_number(self, port_number): def port_type(self): """ **[Required]** Gets the port_type of this PortInformation. - Port type associated for the port number. + Port type associated for the port number. The two port type enums are `CLIENTUTILITY` and `MANAGEMENTUTILITY`. The CLIENTUTILITY enum corresponds to a port which is used by the client daemon. The MANAGEMENTUTILITY enum corresponds to a port used by user management utility. Allowed values for this property are: "CLIENTUTILITY", "MANAGEMENTUTILITY", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -95,7 +95,7 @@ def port_type(self): def port_type(self, port_type): """ Sets the port_type of this PortInformation. - Port type associated for the port number. + Port type associated for the port number. The two port type enums are `CLIENTUTILITY` and `MANAGEMENTUTILITY`. The CLIENTUTILITY enum corresponds to a port which is used by the client daemon. The MANAGEMENTUTILITY enum corresponds to a port used by user management utility. :param port_type: The port_type of this PortInformation. diff --git a/src/oci/key_management/models/pre_co_user_credentials.py b/src/oci/key_management/models/pre_co_user_credentials.py index 7580b09804..93f7d97819 100644 --- a/src/oci/key_management/models/pre_co_user_credentials.py +++ b/src/oci/key_management/models/pre_co_user_credentials.py @@ -46,7 +46,7 @@ def __init__(self, **kwargs): def username(self): """ **[Required]** Gets the username of this PreCoUserCredentials. - The pre crypto officer username.. + The pre crypto officer username, which should be chosen as a non confidential string. :return: The username of this PreCoUserCredentials. @@ -58,7 +58,7 @@ def username(self): def username(self, username): """ Sets the username of this PreCoUserCredentials. - The pre crypto officer username.. + The pre crypto officer username, which should be chosen as a non confidential string. :param username: The username of this PreCoUserCredentials. diff --git a/src/oci/key_management/models/upload_partition_certificates_details.py b/src/oci/key_management/models/upload_partition_certificates_details.py index 209e35344e..c8677a6426 100644 --- a/src/oci/key_management/models/upload_partition_certificates_details.py +++ b/src/oci/key_management/models/upload_partition_certificates_details.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class UploadPartitionCertificatesDetails(object): """ - The details of the partition certificates. + An object that encapsulates the necessary partition certificates. """ def __init__(self, **kwargs): @@ -46,7 +46,7 @@ def __init__(self, **kwargs): def partition_certificate(self): """ **[Required]** Gets the partition_certificate of this UploadPartitionCertificatesDetails. - Base64 encoded (StandardCharsets.UTF_8) Partition Certificate. + Base64 encoded (StandardCharsets.UTF_8) Partition Certificate, which gets created when the CSR is signed. :return: The partition_certificate of this UploadPartitionCertificatesDetails. @@ -58,7 +58,7 @@ def partition_certificate(self): def partition_certificate(self, partition_certificate): """ Sets the partition_certificate of this UploadPartitionCertificatesDetails. - Base64 encoded (StandardCharsets.UTF_8) Partition Certificate. + Base64 encoded (StandardCharsets.UTF_8) Partition Certificate, which gets created when the CSR is signed. :param partition_certificate: The partition_certificate of this UploadPartitionCertificatesDetails. @@ -70,7 +70,7 @@ def partition_certificate(self, partition_certificate): def partition_owner_certificate(self): """ **[Required]** Gets the partition_owner_certificate of this UploadPartitionCertificatesDetails. - Base64 encoded (StandardCharsets.UTF_8) Partition Owner Certificate. + Base64 encoded (StandardCharsets.UTF_8) Partition Owner Certificate, which is used to help sign the CSR. :return: The partition_owner_certificate of this UploadPartitionCertificatesDetails. @@ -82,7 +82,7 @@ def partition_owner_certificate(self): def partition_owner_certificate(self, partition_owner_certificate): """ Sets the partition_owner_certificate of this UploadPartitionCertificatesDetails. - Base64 encoded (StandardCharsets.UTF_8) Partition Owner Certificate. + Base64 encoded (StandardCharsets.UTF_8) Partition Owner Certificate, which is used to help sign the CSR. :param partition_owner_certificate: The partition_owner_certificate of this UploadPartitionCertificatesDetails. diff --git a/src/oci/key_management/models/vault.py b/src/oci/key_management/models/vault.py index 540f149709..c140d2a702 100644 --- a/src/oci/key_management/models/vault.py +++ b/src/oci/key_management/models/vault.py @@ -136,6 +136,10 @@ def __init__(self, **kwargs): The value to assign to the is_primary property of this Vault. :type is_primary: bool + :param is_vault_replicable: + The value to assign to the is_vault_replicable property of this Vault. + :type is_vault_replicable: bool + :param external_key_manager_metadata_summary: The value to assign to the external_key_manager_metadata_summary property of this Vault. :type external_key_manager_metadata_summary: oci.key_management.models.ExternalKeyManagerMetadataSummary @@ -157,6 +161,7 @@ def __init__(self, **kwargs): 'wrappingkey_id': 'str', 'replica_details': 'VaultReplicaDetails', 'is_primary': 'bool', + 'is_vault_replicable': 'bool', 'external_key_manager_metadata_summary': 'ExternalKeyManagerMetadataSummary' } @@ -176,6 +181,7 @@ def __init__(self, **kwargs): 'wrappingkey_id': 'wrappingkeyId', 'replica_details': 'replicaDetails', 'is_primary': 'isPrimary', + 'is_vault_replicable': 'isVaultReplicable', 'external_key_manager_metadata_summary': 'externalKeyManagerMetadataSummary' } @@ -194,6 +200,7 @@ def __init__(self, **kwargs): self._wrappingkey_id = None self._replica_details = None self._is_primary = None + self._is_vault_replicable = None self._external_key_manager_metadata_summary = None @property @@ -618,6 +625,30 @@ def is_primary(self, is_primary): """ self._is_primary = is_primary + @property + def is_vault_replicable(self): + """ + Gets the is_vault_replicable of this Vault. + A Boolean value that indicates whether the Vault has cross region replication capability. Always true for Virtual Private Vaults. + + + :return: The is_vault_replicable of this Vault. + :rtype: bool + """ + return self._is_vault_replicable + + @is_vault_replicable.setter + def is_vault_replicable(self, is_vault_replicable): + """ + Sets the is_vault_replicable of this Vault. + A Boolean value that indicates whether the Vault has cross region replication capability. Always true for Virtual Private Vaults. + + + :param is_vault_replicable: The is_vault_replicable of this Vault. + :type: bool + """ + self._is_vault_replicable = is_vault_replicable + @property def external_key_manager_metadata_summary(self): """ diff --git a/src/oci/load_balancer/models/backend.py b/src/oci/load_balancer/models/backend.py index 438236ed86..38ff6d9d6d 100644 --- a/src/oci/load_balancer/models/backend.py +++ b/src/oci/load_balancer/models/backend.py @@ -216,6 +216,8 @@ def max_connections(self): """ Gets the max_connections of this Backend. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` @@ -230,6 +232,8 @@ def max_connections(self, max_connections): """ Sets the max_connections of this Backend. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/backend_details.py b/src/oci/load_balancer/models/backend_details.py index 74ea3684fd..844aebe206 100644 --- a/src/oci/load_balancer/models/backend_details.py +++ b/src/oci/load_balancer/models/backend_details.py @@ -178,6 +178,8 @@ def max_connections(self): """ Gets the max_connections of this BackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` @@ -192,6 +194,8 @@ def max_connections(self, max_connections): """ Sets the max_connections of this BackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/backend_set.py b/src/oci/load_balancer/models/backend_set.py index 09c61d4f98..2652901a4d 100644 --- a/src/oci/load_balancer/models/backend_set.py +++ b/src/oci/load_balancer/models/backend_set.py @@ -183,7 +183,9 @@ def backend_max_connections(self): """ Gets the backend_max_connections of this BackendSet. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` @@ -198,7 +200,9 @@ def backend_max_connections(self, backend_max_connections): """ Sets the backend_max_connections of this BackendSet. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/backend_set_details.py b/src/oci/load_balancer/models/backend_set_details.py index 6d6468abb0..9328f80f6c 100644 --- a/src/oci/load_balancer/models/backend_set_details.py +++ b/src/oci/load_balancer/models/backend_set_details.py @@ -140,7 +140,9 @@ def backend_max_connections(self): """ Gets the backend_max_connections of this BackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` @@ -155,7 +157,9 @@ def backend_max_connections(self, backend_max_connections): """ Sets the backend_max_connections of this BackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/create_backend_details.py b/src/oci/load_balancer/models/create_backend_details.py index a37baade13..cc76c775bd 100644 --- a/src/oci/load_balancer/models/create_backend_details.py +++ b/src/oci/load_balancer/models/create_backend_details.py @@ -182,6 +182,8 @@ def max_connections(self): """ Gets the max_connections of this CreateBackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then number of simultaneous connections the load balancer can make to + the backend is unlimited. Example: `300` @@ -196,6 +198,8 @@ def max_connections(self, max_connections): """ Sets the max_connections of this CreateBackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then number of simultaneous connections the load balancer can make to + the backend is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/create_backend_set_details.py b/src/oci/load_balancer/models/create_backend_set_details.py index cd9642674a..0ced761b74 100644 --- a/src/oci/load_balancer/models/create_backend_set_details.py +++ b/src/oci/load_balancer/models/create_backend_set_details.py @@ -183,7 +183,9 @@ def backend_max_connections(self): """ Gets the backend_max_connections of this CreateBackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` @@ -198,7 +200,9 @@ def backend_max_connections(self, backend_max_connections): """ Sets the backend_max_connections of this CreateBackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/create_load_balancer_details.py b/src/oci/load_balancer/models/create_load_balancer_details.py index 3b3fbc28c8..a144725d05 100644 --- a/src/oci/load_balancer/models/create_load_balancer_details.py +++ b/src/oci/load_balancer/models/create_load_balancer_details.py @@ -59,6 +59,14 @@ def __init__(self, **kwargs): Allowed values for this property are: "IPV4", "IPV6" :type ip_mode: str + :param is_request_id_enabled: + The value to assign to the is_request_id_enabled property of this CreateLoadBalancerDetails. + :type is_request_id_enabled: bool + + :param request_id_header: + The value to assign to the request_id_header property of this CreateLoadBalancerDetails. + :type request_id_header: str + :param reserved_ips: The value to assign to the reserved_ips property of this CreateLoadBalancerDetails. :type reserved_ips: list[oci.load_balancer.models.ReservedIP] @@ -116,6 +124,8 @@ def __init__(self, **kwargs): 'is_private': 'bool', 'is_delete_protection_enabled': 'bool', 'ip_mode': 'str', + 'is_request_id_enabled': 'bool', + 'request_id_header': 'str', 'reserved_ips': 'list[ReservedIP]', 'listeners': 'dict(str, ListenerDetails)', 'hostnames': 'dict(str, HostnameDetails)', @@ -138,6 +148,8 @@ def __init__(self, **kwargs): 'is_private': 'isPrivate', 'is_delete_protection_enabled': 'isDeleteProtectionEnabled', 'ip_mode': 'ipMode', + 'is_request_id_enabled': 'isRequestIdEnabled', + 'request_id_header': 'requestIdHeader', 'reserved_ips': 'reservedIps', 'listeners': 'listeners', 'hostnames': 'hostnames', @@ -159,6 +171,8 @@ def __init__(self, **kwargs): self._is_private = None self._is_delete_protection_enabled = None self._ip_mode = None + self._is_request_id_enabled = None + self._request_id_header = None self._reserved_ips = None self._listeners = None self._hostnames = None @@ -421,6 +435,108 @@ def ip_mode(self, ip_mode): ) self._ip_mode = ip_mode + @property + def is_request_id_enabled(self): + """ + Gets the is_request_id_enabled of this CreateLoadBalancerDetails. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + New load balancers have the Request Id feature disabled unless isRequestIdEnabled is set to true. + + Example: `true` + + + :return: The is_request_id_enabled of this CreateLoadBalancerDetails. + :rtype: bool + """ + return self._is_request_id_enabled + + @is_request_id_enabled.setter + def is_request_id_enabled(self, is_request_id_enabled): + """ + Sets the is_request_id_enabled of this CreateLoadBalancerDetails. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + New load balancers have the Request Id feature disabled unless isRequestIdEnabled is set to true. + + Example: `true` + + + :param is_request_id_enabled: The is_request_id_enabled of this CreateLoadBalancerDetails. + :type: bool + """ + self._is_request_id_enabled = is_request_id_enabled + + @property + def request_id_header(self): + """ + Gets the request_id_header of this CreateLoadBalancerDetails. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If isRequestIdEnabled is false then this field is ignored. + + If this field is not set or is set to \"\" then this field defaults to X-Request-Id + + **Notes:** + * Unless the header name is \"\" it must start with \"X-\" prefix. + * Setting the header name to \"\" will set it to the default: X-Request-Id. + + + :return: The request_id_header of this CreateLoadBalancerDetails. + :rtype: str + """ + return self._request_id_header + + @request_id_header.setter + def request_id_header(self, request_id_header): + """ + Sets the request_id_header of this CreateLoadBalancerDetails. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If isRequestIdEnabled is false then this field is ignored. + + If this field is not set or is set to \"\" then this field defaults to X-Request-Id + + **Notes:** + * Unless the header name is \"\" it must start with \"X-\" prefix. + * Setting the header name to \"\" will set it to the default: X-Request-Id. + + + :param request_id_header: The request_id_header of this CreateLoadBalancerDetails. + :type: str + """ + self._request_id_header = request_id_header + @property def reserved_ips(self): """ diff --git a/src/oci/load_balancer/models/ip_max_connections.py b/src/oci/load_balancer/models/ip_max_connections.py index 48fe85820a..3ae15d51fe 100644 --- a/src/oci/load_balancer/models/ip_max_connections.py +++ b/src/oci/load_balancer/models/ip_max_connections.py @@ -72,7 +72,10 @@ def ip_addresses(self, ip_addresses): def max_connections(self): """ **[Required]** Gets the max_connections of this IpMaxConnections. - The max number of connections that the specified IPs can make to the Listener. + The maximum number of simultaneous connections that the specified IPs can make to the + Listener. IPs without a maxConnections setting can make either defaultMaxConnections + simultaneous connections to a listener or, if no defaultMaxConnections is specified, an + unlimited number of simultaneous connections to a listener. :return: The max_connections of this IpMaxConnections. @@ -84,7 +87,10 @@ def max_connections(self): def max_connections(self, max_connections): """ Sets the max_connections of this IpMaxConnections. - The max number of connections that the specified IPs can make to the Listener. + The maximum number of simultaneous connections that the specified IPs can make to the + Listener. IPs without a maxConnections setting can make either defaultMaxConnections + simultaneous connections to a listener or, if no defaultMaxConnections is specified, an + unlimited number of simultaneous connections to a listener. :param max_connections: The max_connections of this IpMaxConnections. diff --git a/src/oci/load_balancer/models/load_balancer.py b/src/oci/load_balancer/models/load_balancer.py index 23c2e5c58d..5631c7ce0d 100644 --- a/src/oci/load_balancer/models/load_balancer.py +++ b/src/oci/load_balancer/models/load_balancer.py @@ -96,6 +96,14 @@ def __init__(self, **kwargs): The value to assign to the is_delete_protection_enabled property of this LoadBalancer. :type is_delete_protection_enabled: bool + :param is_request_id_enabled: + The value to assign to the is_request_id_enabled property of this LoadBalancer. + :type is_request_id_enabled: bool + + :param request_id_header: + The value to assign to the request_id_header property of this LoadBalancer. + :type request_id_header: str + :param subnet_ids: The value to assign to the subnet_ids property of this LoadBalancer. :type subnet_ids: list[str] @@ -160,6 +168,8 @@ def __init__(self, **kwargs): 'shape_details': 'ShapeDetails', 'is_private': 'bool', 'is_delete_protection_enabled': 'bool', + 'is_request_id_enabled': 'bool', + 'request_id_header': 'str', 'subnet_ids': 'list[str]', 'network_security_group_ids': 'list[str]', 'listeners': 'dict(str, Listener)', @@ -186,6 +196,8 @@ def __init__(self, **kwargs): 'shape_details': 'shapeDetails', 'is_private': 'isPrivate', 'is_delete_protection_enabled': 'isDeleteProtectionEnabled', + 'is_request_id_enabled': 'isRequestIdEnabled', + 'request_id_header': 'requestIdHeader', 'subnet_ids': 'subnetIds', 'network_security_group_ids': 'networkSecurityGroupIds', 'listeners': 'listeners', @@ -211,6 +223,8 @@ def __init__(self, **kwargs): self._shape_details = None self._is_private = None self._is_delete_protection_enabled = None + self._is_request_id_enabled = None + self._request_id_header = None self._subnet_ids = None self._network_security_group_ids = None self._listeners = None @@ -531,6 +545,92 @@ def is_delete_protection_enabled(self, is_delete_protection_enabled): """ self._is_delete_protection_enabled = is_delete_protection_enabled + @property + def is_request_id_enabled(self): + """ + Gets the is_request_id_enabled of this LoadBalancer. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + Example: `true` + + + :return: The is_request_id_enabled of this LoadBalancer. + :rtype: bool + """ + return self._is_request_id_enabled + + @is_request_id_enabled.setter + def is_request_id_enabled(self, is_request_id_enabled): + """ + Sets the is_request_id_enabled of this LoadBalancer. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + Example: `true` + + + :param is_request_id_enabled: The is_request_id_enabled of this LoadBalancer. + :type: bool + """ + self._is_request_id_enabled = is_request_id_enabled + + @property + def request_id_header(self): + """ + Gets the request_id_header of this LoadBalancer. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If this field is set to \"\" this field defaults to X-Request-Id. + + + :return: The request_id_header of this LoadBalancer. + :rtype: str + """ + return self._request_id_header + + @request_id_header.setter + def request_id_header(self, request_id_header): + """ + Sets the request_id_header of this LoadBalancer. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If this field is set to \"\" this field defaults to X-Request-Id. + + + :param request_id_header: The request_id_header of this LoadBalancer. + :type: str + """ + self._request_id_header = request_id_header + @property def subnet_ids(self): """ diff --git a/src/oci/load_balancer/models/update_backend_details.py b/src/oci/load_balancer/models/update_backend_details.py index 0451374c2d..dcdefeceb3 100644 --- a/src/oci/load_balancer/models/update_backend_details.py +++ b/src/oci/load_balancer/models/update_backend_details.py @@ -108,6 +108,8 @@ def max_connections(self): """ Gets the max_connections of this UpdateBackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` @@ -122,6 +124,8 @@ def max_connections(self, max_connections): """ Sets the max_connections of this UpdateBackendDetails. The maximum number of simultaneous connections the load balancer can make to the backend. + If this is not set then the maximum number of simultaneous connections the load balancer + can make to the backend is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/update_backend_set_details.py b/src/oci/load_balancer/models/update_backend_set_details.py index 837f22f587..ea040ee223 100644 --- a/src/oci/load_balancer/models/update_backend_set_details.py +++ b/src/oci/load_balancer/models/update_backend_set_details.py @@ -142,7 +142,9 @@ def backend_max_connections(self): """ Gets the backend_max_connections of this UpdateBackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` @@ -157,7 +159,9 @@ def backend_max_connections(self, backend_max_connections): """ Sets the backend_max_connections of this UpdateBackendSetDetails. The maximum number of simultaneous connections the load balancer can make to any backend - in the backend set unless the backend has its own maxConnections setting. + in the backend set unless the backend has its own maxConnections setting. If this is not + set then the number of simultaneous connections the load balancer can make to any backend + in the backend set unless the backend has its own maxConnections setting is unlimited. Example: `300` diff --git a/src/oci/load_balancer/models/update_load_balancer_details.py b/src/oci/load_balancer/models/update_load_balancer_details.py index 28596d73d0..603560dbbc 100644 --- a/src/oci/load_balancer/models/update_load_balancer_details.py +++ b/src/oci/load_balancer/models/update_load_balancer_details.py @@ -30,6 +30,14 @@ def __init__(self, **kwargs): The value to assign to the is_delete_protection_enabled property of this UpdateLoadBalancerDetails. :type is_delete_protection_enabled: bool + :param is_request_id_enabled: + The value to assign to the is_request_id_enabled property of this UpdateLoadBalancerDetails. + :type is_request_id_enabled: bool + + :param request_id_header: + The value to assign to the request_id_header property of this UpdateLoadBalancerDetails. + :type request_id_header: str + :param freeform_tags: The value to assign to the freeform_tags property of this UpdateLoadBalancerDetails. :type freeform_tags: dict(str, str) @@ -42,6 +50,8 @@ def __init__(self, **kwargs): self.swagger_types = { 'display_name': 'str', 'is_delete_protection_enabled': 'bool', + 'is_request_id_enabled': 'bool', + 'request_id_header': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' } @@ -49,12 +59,16 @@ def __init__(self, **kwargs): self.attribute_map = { 'display_name': 'displayName', 'is_delete_protection_enabled': 'isDeleteProtectionEnabled', + 'is_request_id_enabled': 'isRequestIdEnabled', + 'request_id_header': 'requestIdHeader', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' } self._display_name = None self._is_delete_protection_enabled = None + self._is_request_id_enabled = None + self._request_id_header = None self._freeform_tags = None self._defined_tags = None @@ -128,6 +142,104 @@ def is_delete_protection_enabled(self, is_delete_protection_enabled): """ self._is_delete_protection_enabled = is_delete_protection_enabled + @property + def is_request_id_enabled(self): + """ + Gets the is_request_id_enabled of this UpdateLoadBalancerDetails. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + New load balancers have the Request Id feature enabled unless isRequestIdEnabled is set to False. + + Example: `true` + + + :return: The is_request_id_enabled of this UpdateLoadBalancerDetails. + :rtype: bool + """ + return self._is_request_id_enabled + + @is_request_id_enabled.setter + def is_request_id_enabled(self, is_request_id_enabled): + """ + Sets the is_request_id_enabled of this UpdateLoadBalancerDetails. + Whether or not the load balancer has the Request Id feature enabled for HTTP listeners. + + If \"true\", the load balancer will attach a unique request id header to every request + passed through from the load balancer to load balancer backends. This same request id + header also will be added to the response the lb received from the backend handling + the request before the load balancer returns the response to the requestor. The name + of the unique request id header is set the by value of requestIdHeader. + + If \"false\", the loadbalancer not add this unique request id header to either the request + passed through to the load balancer backends nor to the reponse returned to the user. + + New load balancers have the Request Id feature enabled unless isRequestIdEnabled is set to False. + + Example: `true` + + + :param is_request_id_enabled: The is_request_id_enabled of this UpdateLoadBalancerDetails. + :type: bool + """ + self._is_request_id_enabled = is_request_id_enabled + + @property + def request_id_header(self): + """ + Gets the request_id_header of this UpdateLoadBalancerDetails. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If isRequestIdEnabled is false then this field is ignored. + + **Notes:** + * Unless the header name is \"\" it must start with \"X-\" prefix. + * Setting the header name to \"\" will set it to the default: X-Request-Id. + + + :return: The request_id_header of this UpdateLoadBalancerDetails. + :rtype: str + """ + return self._request_id_header + + @request_id_header.setter + def request_id_header(self, request_id_header): + """ + Sets the request_id_header of this UpdateLoadBalancerDetails. + If isRequestIdEnabled is true then this field contains the name of the header field + that contains the unique request id that is attached to every request from + the load balancer to the load balancer backends and to every response from the load + balancer. + + If a request to the load balancer already contains a header with same name as specified + in requestIdHeader then the load balancer will not change the value of that field. + + If isRequestIdEnabled is false then this field is ignored. + + **Notes:** + * Unless the header name is \"\" it must start with \"X-\" prefix. + * Setting the header name to \"\" will set it to the default: X-Request-Id. + + + :param request_id_header: The request_id_header of this UpdateLoadBalancerDetails. + :type: str + """ + self._request_id_header = request_id_header + @property def freeform_tags(self): """ diff --git a/src/oci/mysql/models/__init__.py b/src/oci/mysql/models/__init__.py index 9cc3637ad6..7224d96746 100644 --- a/src/oci/mysql/models/__init__.py +++ b/src/oci/mysql/models/__init__.py @@ -43,6 +43,7 @@ from .create_deletion_policy_details import CreateDeletionPolicyDetails from .create_maintenance_details import CreateMaintenanceDetails from .create_replica_details import CreateReplicaDetails +from .customer_contact import CustomerContact from .data_storage import DataStorage from .data_storage_details import DataStorageDetails from .db_system import DbSystem @@ -136,6 +137,7 @@ "CreateDeletionPolicyDetails": CreateDeletionPolicyDetails, "CreateMaintenanceDetails": CreateMaintenanceDetails, "CreateReplicaDetails": CreateReplicaDetails, + "CustomerContact": CustomerContact, "DataStorage": DataStorage, "DataStorageDetails": DataStorageDetails, "DbSystem": DbSystem, diff --git a/src/oci/mysql/models/create_db_system_details.py b/src/oci/mysql/models/create_db_system_details.py index 7c022f9df1..73d3a74d68 100644 --- a/src/oci/mysql/models/create_db_system_details.py +++ b/src/oci/mysql/models/create_db_system_details.py @@ -146,6 +146,10 @@ def __init__(self, **kwargs): The value to assign to the secure_connections property of this CreateDbSystemDetails. :type secure_connections: oci.mysql.models.SecureConnectionDetails + :param customer_contacts: + The value to assign to the customer_contacts property of this CreateDbSystemDetails. + :type customer_contacts: list[oci.mysql.models.CustomerContact] + """ self.swagger_types = { 'display_name': 'str', @@ -174,7 +178,8 @@ def __init__(self, **kwargs): 'deletion_policy': 'CreateDeletionPolicyDetails', 'crash_recovery': 'str', 'database_management': 'str', - 'secure_connections': 'SecureConnectionDetails' + 'secure_connections': 'SecureConnectionDetails', + 'customer_contacts': 'list[CustomerContact]' } self.attribute_map = { @@ -204,7 +209,8 @@ def __init__(self, **kwargs): 'deletion_policy': 'deletionPolicy', 'crash_recovery': 'crashRecovery', 'database_management': 'databaseManagement', - 'secure_connections': 'secureConnections' + 'secure_connections': 'secureConnections', + 'customer_contacts': 'customerContacts' } self._display_name = None @@ -234,6 +240,7 @@ def __init__(self, **kwargs): self._crash_recovery = None self._database_management = None self._secure_connections = None + self._customer_contacts = None @property def display_name(self): @@ -949,6 +956,34 @@ def secure_connections(self, secure_connections): """ self._secure_connections = secure_connections + @property + def customer_contacts(self): + """ + Gets the customer_contacts of this CreateDbSystemDetails. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :return: The customer_contacts of this CreateDbSystemDetails. + :rtype: list[oci.mysql.models.CustomerContact] + """ + return self._customer_contacts + + @customer_contacts.setter + def customer_contacts(self, customer_contacts): + """ + Sets the customer_contacts of this CreateDbSystemDetails. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :param customer_contacts: The customer_contacts of this CreateDbSystemDetails. + :type: list[oci.mysql.models.CustomerContact] + """ + self._customer_contacts = customer_contacts + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/mysql/models/customer_contact.py b/src/oci/mysql/models/customer_contact.py new file mode 100644 index 0000000000..75d34236f0 --- /dev/null +++ b/src/oci/mysql/models/customer_contact.py @@ -0,0 +1,72 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20190415 + + +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 CustomerContact(object): + """ + Customer contact information that will be used by Oracle to provide notifications needed by DB System administrators. + """ + + def __init__(self, **kwargs): + """ + Initializes a new CustomerContact object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param email: + The value to assign to the email property of this CustomerContact. + :type email: str + + """ + self.swagger_types = { + 'email': 'str' + } + + self.attribute_map = { + 'email': 'email' + } + + self._email = None + + @property + def email(self): + """ + **[Required]** Gets the email of this CustomerContact. + The email address used by Oracle to send notifications regarding the DB System. + + + :return: The email of this CustomerContact. + :rtype: str + """ + return self._email + + @email.setter + def email(self, email): + """ + Sets the email of this CustomerContact. + The email address used by Oracle to send notifications regarding the DB System. + + + :param email: The email of this CustomerContact. + :type: str + """ + self._email = email + + 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/mysql/models/db_system.py b/src/oci/mysql/models/db_system.py index b7a11c6dd6..7ac5dc4d76 100644 --- a/src/oci/mysql/models/db_system.py +++ b/src/oci/mysql/models/db_system.py @@ -214,6 +214,10 @@ def __init__(self, **kwargs): The value to assign to the secure_connections property of this DbSystem. :type secure_connections: oci.mysql.models.SecureConnectionDetails + :param customer_contacts: + The value to assign to the customer_contacts property of this DbSystem. + :type customer_contacts: list[oci.mysql.models.CustomerContact] + """ self.swagger_types = { 'id': 'str', @@ -251,7 +255,8 @@ def __init__(self, **kwargs): 'crash_recovery': 'str', 'point_in_time_recovery_details': 'PointInTimeRecoveryDetails', 'database_management': 'str', - 'secure_connections': 'SecureConnectionDetails' + 'secure_connections': 'SecureConnectionDetails', + 'customer_contacts': 'list[CustomerContact]' } self.attribute_map = { @@ -290,7 +295,8 @@ def __init__(self, **kwargs): 'crash_recovery': 'crashRecovery', 'point_in_time_recovery_details': 'pointInTimeRecoveryDetails', 'database_management': 'databaseManagement', - 'secure_connections': 'secureConnections' + 'secure_connections': 'secureConnections', + 'customer_contacts': 'customerContacts' } self._id = None @@ -329,6 +335,7 @@ def __init__(self, **kwargs): self._point_in_time_recovery_details = None self._database_management = None self._secure_connections = None + self._customer_contacts = None @property def id(self): @@ -1228,6 +1235,34 @@ def secure_connections(self, secure_connections): """ self._secure_connections = secure_connections + @property + def customer_contacts(self): + """ + Gets the customer_contacts of this DbSystem. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :return: The customer_contacts of this DbSystem. + :rtype: list[oci.mysql.models.CustomerContact] + """ + return self._customer_contacts + + @customer_contacts.setter + def customer_contacts(self, customer_contacts): + """ + Sets the customer_contacts of this DbSystem. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :param customer_contacts: The customer_contacts of this DbSystem. + :type: list[oci.mysql.models.CustomerContact] + """ + self._customer_contacts = customer_contacts + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/mysql/models/update_db_system_details.py b/src/oci/mysql/models/update_db_system_details.py index f600048be4..201730067b 100644 --- a/src/oci/mysql/models/update_db_system_details.py +++ b/src/oci/mysql/models/update_db_system_details.py @@ -138,6 +138,10 @@ def __init__(self, **kwargs): The value to assign to the secure_connections property of this UpdateDbSystemDetails. :type secure_connections: oci.mysql.models.SecureConnectionDetails + :param customer_contacts: + The value to assign to the customer_contacts property of this UpdateDbSystemDetails. + :type customer_contacts: list[oci.mysql.models.CustomerContact] + """ self.swagger_types = { 'display_name': 'str', @@ -164,7 +168,8 @@ def __init__(self, **kwargs): 'deletion_policy': 'UpdateDeletionPolicyDetails', 'crash_recovery': 'str', 'database_management': 'str', - 'secure_connections': 'SecureConnectionDetails' + 'secure_connections': 'SecureConnectionDetails', + 'customer_contacts': 'list[CustomerContact]' } self.attribute_map = { @@ -192,7 +197,8 @@ def __init__(self, **kwargs): 'deletion_policy': 'deletionPolicy', 'crash_recovery': 'crashRecovery', 'database_management': 'databaseManagement', - 'secure_connections': 'secureConnections' + 'secure_connections': 'secureConnections', + 'customer_contacts': 'customerContacts' } self._display_name = None @@ -220,6 +226,7 @@ def __init__(self, **kwargs): self._crash_recovery = None self._database_management = None self._secure_connections = None + self._customer_contacts = None @property def display_name(self): @@ -905,6 +912,34 @@ def secure_connections(self, secure_connections): """ self._secure_connections = secure_connections + @property + def customer_contacts(self): + """ + Gets the customer_contacts of this UpdateDbSystemDetails. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :return: The customer_contacts of this UpdateDbSystemDetails. + :rtype: list[oci.mysql.models.CustomerContact] + """ + return self._customer_contacts + + @customer_contacts.setter + def customer_contacts(self, customer_contacts): + """ + Sets the customer_contacts of this UpdateDbSystemDetails. + The list of customer email addresses that receive information from Oracle about the specified OCI DB System resource. + Oracle uses these email addresses to send notifications about planned and unplanned software maintenance updates, information about system hardware, and other information needed by administrators. + Up to 10 email addresses can be added to the customer contacts for a DB System. + + + :param customer_contacts: The customer_contacts of this UpdateDbSystemDetails. + :type: list[oci.mysql.models.CustomerContact] + """ + self._customer_contacts = customer_contacts + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/object_storage/models/__init__.py b/src/oci/object_storage/models/__init__.py index 79ab321067..9abdcfb42d 100644 --- a/src/oci/object_storage/models/__init__.py +++ b/src/oci/object_storage/models/__init__.py @@ -6,6 +6,7 @@ from __future__ import absolute_import +from .access_target_details import AccessTargetDetails from .bucket import Bucket from .bucket_summary import BucketSummary from .commit_multipart_upload_details import CommitMultipartUploadDetails @@ -14,9 +15,11 @@ from .create_bucket_details import CreateBucketDetails from .create_multipart_upload_details import CreateMultipartUploadDetails from .create_preauthenticated_request_details import CreatePreauthenticatedRequestDetails +from .create_private_endpoint_details import CreatePrivateEndpointDetails from .create_replication_policy_details import CreateReplicationPolicyDetails from .create_retention_rule_details import CreateRetentionRuleDetails from .duration import Duration +from .fqdns import Fqdns from .list_objects import ListObjects from .multipart_upload import MultipartUpload from .multipart_upload_part_summary import MultipartUploadPartSummary @@ -30,6 +33,9 @@ from .pattern_details import PatternDetails from .preauthenticated_request import PreauthenticatedRequest from .preauthenticated_request_summary import PreauthenticatedRequestSummary +from .prefix_fqdns import PrefixFqdns +from .private_endpoint import PrivateEndpoint +from .private_endpoint_summary import PrivateEndpointSummary from .put_object_lifecycle_policy_details import PutObjectLifecyclePolicyDetails from .reencrypt_object_details import ReencryptObjectDetails from .rename_object_details import RenameObjectDetails @@ -45,6 +51,7 @@ from .update_bucket_details import UpdateBucketDetails from .update_namespace_metadata_details import UpdateNamespaceMetadataDetails from .update_object_storage_tier_details import UpdateObjectStorageTierDetails +from .update_private_endpoint_details import UpdatePrivateEndpointDetails from .update_retention_rule_details import UpdateRetentionRuleDetails from .work_request import WorkRequest from .work_request_error import WorkRequestError @@ -54,6 +61,7 @@ # Maps type names to classes for object_storage services. object_storage_type_mapping = { + "AccessTargetDetails": AccessTargetDetails, "Bucket": Bucket, "BucketSummary": BucketSummary, "CommitMultipartUploadDetails": CommitMultipartUploadDetails, @@ -62,9 +70,11 @@ "CreateBucketDetails": CreateBucketDetails, "CreateMultipartUploadDetails": CreateMultipartUploadDetails, "CreatePreauthenticatedRequestDetails": CreatePreauthenticatedRequestDetails, + "CreatePrivateEndpointDetails": CreatePrivateEndpointDetails, "CreateReplicationPolicyDetails": CreateReplicationPolicyDetails, "CreateRetentionRuleDetails": CreateRetentionRuleDetails, "Duration": Duration, + "Fqdns": Fqdns, "ListObjects": ListObjects, "MultipartUpload": MultipartUpload, "MultipartUploadPartSummary": MultipartUploadPartSummary, @@ -78,6 +88,9 @@ "PatternDetails": PatternDetails, "PreauthenticatedRequest": PreauthenticatedRequest, "PreauthenticatedRequestSummary": PreauthenticatedRequestSummary, + "PrefixFqdns": PrefixFqdns, + "PrivateEndpoint": PrivateEndpoint, + "PrivateEndpointSummary": PrivateEndpointSummary, "PutObjectLifecyclePolicyDetails": PutObjectLifecyclePolicyDetails, "ReencryptObjectDetails": ReencryptObjectDetails, "RenameObjectDetails": RenameObjectDetails, @@ -93,6 +106,7 @@ "UpdateBucketDetails": UpdateBucketDetails, "UpdateNamespaceMetadataDetails": UpdateNamespaceMetadataDetails, "UpdateObjectStorageTierDetails": UpdateObjectStorageTierDetails, + "UpdatePrivateEndpointDetails": UpdatePrivateEndpointDetails, "UpdateRetentionRuleDetails": UpdateRetentionRuleDetails, "WorkRequest": WorkRequest, "WorkRequestError": WorkRequestError, diff --git a/src/oci/object_storage/models/access_target_details.py b/src/oci/object_storage/models/access_target_details.py new file mode 100644 index 0000000000..5dfff14551 --- /dev/null +++ b/src/oci/object_storage/models/access_target_details.py @@ -0,0 +1,136 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 AccessTargetDetails(object): + """ + Details of the targets that can be accessed by the private endpoint. + """ + + def __init__(self, **kwargs): + """ + Initializes a new AccessTargetDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param namespace: + The value to assign to the namespace property of this AccessTargetDetails. + :type namespace: str + + :param compartment_id: + The value to assign to the compartment_id property of this AccessTargetDetails. + :type compartment_id: str + + :param bucket: + The value to assign to the bucket property of this AccessTargetDetails. + :type bucket: str + + """ + self.swagger_types = { + 'namespace': 'str', + 'compartment_id': 'str', + 'bucket': 'str' + } + + self.attribute_map = { + 'namespace': 'namespace', + 'compartment_id': 'compartmentId', + 'bucket': 'bucket' + } + + self._namespace = None + self._compartment_id = None + self._bucket = None + + @property + def namespace(self): + """ + **[Required]** Gets the namespace of this AccessTargetDetails. + The Object Storage namespace which the private endpoint can access. Wildcards ('*') are allowed. If value is '*', it means all namespaces can be accessed. It cannot be a regex. + + + :return: The namespace of this AccessTargetDetails. + :rtype: str + """ + return self._namespace + + @namespace.setter + def namespace(self, namespace): + """ + Sets the namespace of this AccessTargetDetails. + The Object Storage namespace which the private endpoint can access. Wildcards ('*') are allowed. If value is '*', it means all namespaces can be accessed. It cannot be a regex. + + + :param namespace: The namespace of this AccessTargetDetails. + :type: str + """ + self._namespace = namespace + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this AccessTargetDetails. + The compartment ID which the private endpoint can access. Wildcards ('*') are allowed. If value is '*', it means all compartments in the specified namespace can be accessed. It cannot be a regex. + + + :return: The compartment_id of this AccessTargetDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this AccessTargetDetails. + The compartment ID which the private endpoint can access. Wildcards ('*') are allowed. If value is '*', it means all compartments in the specified namespace can be accessed. It cannot be a regex. + + + :param compartment_id: The compartment_id of this AccessTargetDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def bucket(self): + """ + **[Required]** Gets the bucket of this AccessTargetDetails. + The name of the bucket. Avoid entering confidential information. Wildcards ('*') are allowed. If value is '*', it means all buckets in the specified namespace and compartment can be accessed. It cannot be a regex. + Example: my-new-bucket1 + + + :return: The bucket of this AccessTargetDetails. + :rtype: str + """ + return self._bucket + + @bucket.setter + def bucket(self, bucket): + """ + Sets the bucket of this AccessTargetDetails. + The name of the bucket. Avoid entering confidential information. Wildcards ('*') are allowed. If value is '*', it means all buckets in the specified namespace and compartment can be accessed. It cannot be a regex. + Example: my-new-bucket1 + + + :param bucket: The bucket of this AccessTargetDetails. + :type: str + """ + self._bucket = bucket + + 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/create_private_endpoint_details.py b/src/oci/object_storage/models/create_private_endpoint_details.py new file mode 100644 index 0000000000..be0c3538f1 --- /dev/null +++ b/src/oci/object_storage/models/create_private_endpoint_details.py @@ -0,0 +1,389 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 CreatePrivateEndpointDetails(object): + """ + Details to create a private endpoint + """ + + def __init__(self, **kwargs): + """ + Initializes a new CreatePrivateEndpointDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param name: + The value to assign to the name property of this CreatePrivateEndpointDetails. + :type name: str + + :param compartment_id: + The value to assign to the compartment_id property of this CreatePrivateEndpointDetails. + :type compartment_id: str + + :param subnet_id: + The value to assign to the subnet_id property of this CreatePrivateEndpointDetails. + :type subnet_id: str + + :param prefix: + The value to assign to the prefix property of this CreatePrivateEndpointDetails. + :type prefix: str + + :param additional_prefixes: + The value to assign to the additional_prefixes property of this CreatePrivateEndpointDetails. + :type additional_prefixes: list[str] + + :param private_endpoint_ip: + The value to assign to the private_endpoint_ip property of this CreatePrivateEndpointDetails. + :type private_endpoint_ip: str + + :param nsg_ids: + The value to assign to the nsg_ids property of this CreatePrivateEndpointDetails. + :type nsg_ids: list[str] + + :param access_targets: + The value to assign to the access_targets property of this CreatePrivateEndpointDetails. + :type access_targets: list[oci.object_storage.models.AccessTargetDetails] + + :param freeform_tags: + The value to assign to the freeform_tags property of this CreatePrivateEndpointDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this CreatePrivateEndpointDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'name': 'str', + 'compartment_id': 'str', + 'subnet_id': 'str', + 'prefix': 'str', + 'additional_prefixes': 'list[str]', + 'private_endpoint_ip': 'str', + 'nsg_ids': 'list[str]', + 'access_targets': 'list[AccessTargetDetails]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'name': 'name', + 'compartment_id': 'compartmentId', + 'subnet_id': 'subnetId', + 'prefix': 'prefix', + 'additional_prefixes': 'additionalPrefixes', + 'private_endpoint_ip': 'privateEndpointIp', + 'nsg_ids': 'nsgIds', + 'access_targets': 'accessTargets', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._name = None + self._compartment_id = None + self._subnet_id = None + self._prefix = None + self._additional_prefixes = None + self._private_endpoint_ip = None + self._nsg_ids = None + self._access_targets = None + self._freeform_tags = None + self._defined_tags = None + + @property + def name(self): + """ + **[Required]** Gets the name of this CreatePrivateEndpointDetails. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :return: The name of this CreatePrivateEndpointDetails. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this CreatePrivateEndpointDetails. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :param name: The name of this CreatePrivateEndpointDetails. + :type: str + """ + self._name = name + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this CreatePrivateEndpointDetails. + The ID of the compartment in which to create the Private Endpoint. + + + :return: The compartment_id of this CreatePrivateEndpointDetails. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this CreatePrivateEndpointDetails. + The ID of the compartment in which to create the Private Endpoint. + + + :param compartment_id: The compartment_id of this CreatePrivateEndpointDetails. + :type: str + """ + self._compartment_id = compartment_id + + @property + def subnet_id(self): + """ + **[Required]** Gets the subnet_id of this CreatePrivateEndpointDetails. + The OCID of the customer's subnet where the private endpoint VNIC will reside. + + + :return: The subnet_id of this CreatePrivateEndpointDetails. + :rtype: str + """ + return self._subnet_id + + @subnet_id.setter + def subnet_id(self, subnet_id): + """ + Sets the subnet_id of this CreatePrivateEndpointDetails. + The OCID of the customer's subnet where the private endpoint VNIC will reside. + + + :param subnet_id: The subnet_id of this CreatePrivateEndpointDetails. + :type: str + """ + self._subnet_id = subnet_id + + @property + def prefix(self): + """ + **[Required]** Gets the prefix of this CreatePrivateEndpointDetails. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :return: The prefix of this CreatePrivateEndpointDetails. + :rtype: str + """ + return self._prefix + + @prefix.setter + def prefix(self, prefix): + """ + Sets the prefix of this CreatePrivateEndpointDetails. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :param prefix: The prefix of this CreatePrivateEndpointDetails. + :type: str + """ + self._prefix = prefix + + @property + def additional_prefixes(self): + """ + Gets the additional_prefixes of this CreatePrivateEndpointDetails. + A list of additional prefix that you can provide along with any other prefix. These resulting endpointFqdn's are added to the + customer VCN's DNS record. + + + :return: The additional_prefixes of this CreatePrivateEndpointDetails. + :rtype: list[str] + """ + return self._additional_prefixes + + @additional_prefixes.setter + def additional_prefixes(self, additional_prefixes): + """ + Sets the additional_prefixes of this CreatePrivateEndpointDetails. + A list of additional prefix that you can provide along with any other prefix. These resulting endpointFqdn's are added to the + customer VCN's DNS record. + + + :param additional_prefixes: The additional_prefixes of this CreatePrivateEndpointDetails. + :type: list[str] + """ + self._additional_prefixes = additional_prefixes + + @property + def private_endpoint_ip(self): + """ + Gets the private_endpoint_ip of this CreatePrivateEndpointDetails. + The private IP address to assign to this private endpoint. If you provide a value, + it must be an available IP address in the customer's subnet. If it's not available, an error + is returned. + + If you do not provide a value, an available IP address in the subnet is automatically chosen. + + + :return: The private_endpoint_ip of this CreatePrivateEndpointDetails. + :rtype: str + """ + return self._private_endpoint_ip + + @private_endpoint_ip.setter + def private_endpoint_ip(self, private_endpoint_ip): + """ + Sets the private_endpoint_ip of this CreatePrivateEndpointDetails. + The private IP address to assign to this private endpoint. If you provide a value, + it must be an available IP address in the customer's subnet. If it's not available, an error + is returned. + + If you do not provide a value, an available IP address in the subnet is automatically chosen. + + + :param private_endpoint_ip: The private_endpoint_ip of this CreatePrivateEndpointDetails. + :type: str + """ + self._private_endpoint_ip = private_endpoint_ip + + @property + def nsg_ids(self): + """ + Gets the nsg_ids of this CreatePrivateEndpointDetails. + A list of the OCIDs of the network security groups (NSGs) to add the private endpoint's VNIC to. + For more information about NSGs, see + :class:`NetworkSecurityGroup`. + + + :return: The nsg_ids of this CreatePrivateEndpointDetails. + :rtype: list[str] + """ + return self._nsg_ids + + @nsg_ids.setter + def nsg_ids(self, nsg_ids): + """ + Sets the nsg_ids of this CreatePrivateEndpointDetails. + A list of the OCIDs of the network security groups (NSGs) to add the private endpoint's VNIC to. + For more information about NSGs, see + :class:`NetworkSecurityGroup`. + + + :param nsg_ids: The nsg_ids of this CreatePrivateEndpointDetails. + :type: list[str] + """ + self._nsg_ids = nsg_ids + + @property + def access_targets(self): + """ + **[Required]** Gets the access_targets of this CreatePrivateEndpointDetails. + A list of targets that can be accessed by the private endpoint. + + + :return: The access_targets of this CreatePrivateEndpointDetails. + :rtype: list[oci.object_storage.models.AccessTargetDetails] + """ + return self._access_targets + + @access_targets.setter + def access_targets(self, access_targets): + """ + Sets the access_targets of this CreatePrivateEndpointDetails. + A list of targets that can be accessed by the private endpoint. + + + :param access_targets: The access_targets of this CreatePrivateEndpointDetails. + :type: list[oci.object_storage.models.AccessTargetDetails] + """ + self._access_targets = access_targets + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this CreatePrivateEndpointDetails. + 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 CreatePrivateEndpointDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this CreatePrivateEndpointDetails. + 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 CreatePrivateEndpointDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this CreatePrivateEndpointDetails. + 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/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this CreatePrivateEndpointDetails. + :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 CreatePrivateEndpointDetails. + 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/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this CreatePrivateEndpointDetails. + :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/object_storage/models/fqdns.py b/src/oci/object_storage/models/fqdns.py new file mode 100644 index 0000000000..10d28a67fe --- /dev/null +++ b/src/oci/object_storage/models/fqdns.py @@ -0,0 +1,99 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 Fqdns(object): + """ + The object representing FQDN details formed using prefix and additionalPrefixes. + """ + + def __init__(self, **kwargs): + """ + Initializes a new Fqdns object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param prefix_fqdns: + The value to assign to the prefix_fqdns property of this Fqdns. + :type prefix_fqdns: oci.object_storage.models.PrefixFqdns + + :param additional_prefixes_fqdns: + The value to assign to the additional_prefixes_fqdns property of this Fqdns. + :type additional_prefixes_fqdns: dict(str, PrefixFqdns) + + """ + self.swagger_types = { + 'prefix_fqdns': 'PrefixFqdns', + 'additional_prefixes_fqdns': 'dict(str, PrefixFqdns)' + } + + self.attribute_map = { + 'prefix_fqdns': 'prefixFqdns', + 'additional_prefixes_fqdns': 'additionalPrefixesFqdns' + } + + self._prefix_fqdns = None + self._additional_prefixes_fqdns = None + + @property + def prefix_fqdns(self): + """ + Gets the prefix_fqdns of this Fqdns. + + :return: The prefix_fqdns of this Fqdns. + :rtype: oci.object_storage.models.PrefixFqdns + """ + return self._prefix_fqdns + + @prefix_fqdns.setter + def prefix_fqdns(self, prefix_fqdns): + """ + Sets the prefix_fqdns of this Fqdns. + + :param prefix_fqdns: The prefix_fqdns of this Fqdns. + :type: oci.object_storage.models.PrefixFqdns + """ + self._prefix_fqdns = prefix_fqdns + + @property + def additional_prefixes_fqdns(self): + """ + Gets the additional_prefixes_fqdns of this Fqdns. + An object containing FQDNs formed using additionalPrefixes. + + + :return: The additional_prefixes_fqdns of this Fqdns. + :rtype: dict(str, PrefixFqdns) + """ + return self._additional_prefixes_fqdns + + @additional_prefixes_fqdns.setter + def additional_prefixes_fqdns(self, additional_prefixes_fqdns): + """ + Sets the additional_prefixes_fqdns of this Fqdns. + An object containing FQDNs formed using additionalPrefixes. + + + :param additional_prefixes_fqdns: The additional_prefixes_fqdns of this Fqdns. + :type: dict(str, PrefixFqdns) + """ + self._additional_prefixes_fqdns = additional_prefixes_fqdns + + 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/prefix_fqdns.py b/src/oci/object_storage/models/prefix_fqdns.py new file mode 100644 index 0000000000..d3e2f8ca20 --- /dev/null +++ b/src/oci/object_storage/models/prefix_fqdns.py @@ -0,0 +1,134 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 PrefixFqdns(object): + """ + An object containing FQDNs + """ + + def __init__(self, **kwargs): + """ + Initializes a new PrefixFqdns object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param object_storage_api_fqdn: + The value to assign to the object_storage_api_fqdn property of this PrefixFqdns. + :type object_storage_api_fqdn: str + + :param s3_compatibility_api_fqdn: + The value to assign to the s3_compatibility_api_fqdn property of this PrefixFqdns. + :type s3_compatibility_api_fqdn: str + + :param swift_api_fqdn: + The value to assign to the swift_api_fqdn property of this PrefixFqdns. + :type swift_api_fqdn: str + + """ + self.swagger_types = { + 'object_storage_api_fqdn': 'str', + 's3_compatibility_api_fqdn': 'str', + 'swift_api_fqdn': 'str' + } + + self.attribute_map = { + 'object_storage_api_fqdn': 'objectStorageApiFqdn', + 's3_compatibility_api_fqdn': 's3CompatibilityApiFqdn', + 'swift_api_fqdn': 'swiftApiFqdn' + } + + self._object_storage_api_fqdn = None + self._s3_compatibility_api_fqdn = None + self._swift_api_fqdn = None + + @property + def object_storage_api_fqdn(self): + """ + Gets the object_storage_api_fqdn of this PrefixFqdns. + ObjectStorage API FQDN + + + :return: The object_storage_api_fqdn of this PrefixFqdns. + :rtype: str + """ + return self._object_storage_api_fqdn + + @object_storage_api_fqdn.setter + def object_storage_api_fqdn(self, object_storage_api_fqdn): + """ + Sets the object_storage_api_fqdn of this PrefixFqdns. + ObjectStorage API FQDN + + + :param object_storage_api_fqdn: The object_storage_api_fqdn of this PrefixFqdns. + :type: str + """ + self._object_storage_api_fqdn = object_storage_api_fqdn + + @property + def s3_compatibility_api_fqdn(self): + """ + Gets the s3_compatibility_api_fqdn of this PrefixFqdns. + S3 Compatibility API FQDN + + + :return: The s3_compatibility_api_fqdn of this PrefixFqdns. + :rtype: str + """ + return self._s3_compatibility_api_fqdn + + @s3_compatibility_api_fqdn.setter + def s3_compatibility_api_fqdn(self, s3_compatibility_api_fqdn): + """ + Sets the s3_compatibility_api_fqdn of this PrefixFqdns. + S3 Compatibility API FQDN + + + :param s3_compatibility_api_fqdn: The s3_compatibility_api_fqdn of this PrefixFqdns. + :type: str + """ + self._s3_compatibility_api_fqdn = s3_compatibility_api_fqdn + + @property + def swift_api_fqdn(self): + """ + Gets the swift_api_fqdn of this PrefixFqdns. + Swift API FQDN + + + :return: The swift_api_fqdn of this PrefixFqdns. + :rtype: str + """ + return self._swift_api_fqdn + + @swift_api_fqdn.setter + def swift_api_fqdn(self, swift_api_fqdn): + """ + Sets the swift_api_fqdn of this PrefixFqdns. + Swift API FQDN + + + :param swift_api_fqdn: The swift_api_fqdn of this PrefixFqdns. + :type: str + """ + self._swift_api_fqdn = swift_api_fqdn + + 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/private_endpoint.py b/src/oci/object_storage/models/private_endpoint.py new file mode 100644 index 0000000000..b37389d690 --- /dev/null +++ b/src/oci/object_storage/models/private_endpoint.py @@ -0,0 +1,685 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 PrivateEndpoint(object): + """ + A private endpoint makes your service accessible through a private IP in the customer's private network. A private endpoint has a name and is associated with a namespace and a single compartment. + """ + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "CREATING" + LIFECYCLE_STATE_CREATING = "CREATING" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "ACTIVE" + LIFECYCLE_STATE_ACTIVE = "ACTIVE" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "INACTIVE" + LIFECYCLE_STATE_INACTIVE = "INACTIVE" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "UPDATING" + LIFECYCLE_STATE_UPDATING = "UPDATING" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "DELETING" + LIFECYCLE_STATE_DELETING = "DELETING" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "DELETED" + LIFECYCLE_STATE_DELETED = "DELETED" + + #: A constant which can be used with the lifecycle_state property of a PrivateEndpoint. + #: This constant has a value of "FAILED" + LIFECYCLE_STATE_FAILED = "FAILED" + + def __init__(self, **kwargs): + """ + Initializes a new PrivateEndpoint object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param name: + The value to assign to the name property of this PrivateEndpoint. + :type name: str + + :param namespace: + The value to assign to the namespace property of this PrivateEndpoint. + :type namespace: str + + :param compartment_id: + The value to assign to the compartment_id property of this PrivateEndpoint. + :type compartment_id: str + + :param created_by: + The value to assign to the created_by property of this PrivateEndpoint. + :type created_by: str + + :param time_created: + The value to assign to the time_created property of this PrivateEndpoint. + :type time_created: datetime + + :param time_modified: + The value to assign to the time_modified property of this PrivateEndpoint. + :type time_modified: datetime + + :param subnet_id: + The value to assign to the subnet_id property of this PrivateEndpoint. + :type subnet_id: str + + :param private_endpoint_ip: + The value to assign to the private_endpoint_ip property of this PrivateEndpoint. + :type private_endpoint_ip: str + + :param prefix: + The value to assign to the prefix property of this PrivateEndpoint. + :type prefix: str + + :param additional_prefixes: + The value to assign to the additional_prefixes property of this PrivateEndpoint. + :type additional_prefixes: list[str] + + :param nsg_ids: + The value to assign to the nsg_ids property of this PrivateEndpoint. + :type nsg_ids: list[str] + + :param fqdns: + The value to assign to the fqdns property of this PrivateEndpoint. + :type fqdns: oci.object_storage.models.Fqdns + + :param etag: + The value to assign to the etag property of this PrivateEndpoint. + :type etag: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this PrivateEndpoint. + Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + :type lifecycle_state: str + + :param access_targets: + The value to assign to the access_targets property of this PrivateEndpoint. + :type access_targets: list[oci.object_storage.models.AccessTargetDetails] + + :param freeform_tags: + The value to assign to the freeform_tags property of this PrivateEndpoint. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this PrivateEndpoint. + :type defined_tags: dict(str, dict(str, object)) + + :param id: + The value to assign to the id property of this PrivateEndpoint. + :type id: str + + """ + self.swagger_types = { + 'name': 'str', + 'namespace': 'str', + 'compartment_id': 'str', + 'created_by': 'str', + 'time_created': 'datetime', + 'time_modified': 'datetime', + 'subnet_id': 'str', + 'private_endpoint_ip': 'str', + 'prefix': 'str', + 'additional_prefixes': 'list[str]', + 'nsg_ids': 'list[str]', + 'fqdns': 'Fqdns', + 'etag': 'str', + 'lifecycle_state': 'str', + 'access_targets': 'list[AccessTargetDetails]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))', + 'id': 'str' + } + + self.attribute_map = { + 'name': 'name', + 'namespace': 'namespace', + 'compartment_id': 'compartmentId', + 'created_by': 'createdBy', + 'time_created': 'timeCreated', + 'time_modified': 'timeModified', + 'subnet_id': 'subnetId', + 'private_endpoint_ip': 'privateEndpointIp', + 'prefix': 'prefix', + 'additional_prefixes': 'additionalPrefixes', + 'nsg_ids': 'nsgIds', + 'fqdns': 'fqdns', + 'etag': 'etag', + 'lifecycle_state': 'lifecycleState', + 'access_targets': 'accessTargets', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags', + 'id': 'id' + } + + self._name = None + self._namespace = None + self._compartment_id = None + self._created_by = None + self._time_created = None + self._time_modified = None + self._subnet_id = None + self._private_endpoint_ip = None + self._prefix = None + self._additional_prefixes = None + self._nsg_ids = None + self._fqdns = None + self._etag = None + self._lifecycle_state = None + self._access_targets = None + self._freeform_tags = None + self._defined_tags = None + self._id = None + + @property + def name(self): + """ + **[Required]** Gets the name of this PrivateEndpoint. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :return: The name of this PrivateEndpoint. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this PrivateEndpoint. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :param name: The name of this PrivateEndpoint. + :type: str + """ + self._name = name + + @property + def namespace(self): + """ + **[Required]** Gets the namespace of this PrivateEndpoint. + The Object Storage namespace associated with the private enpoint. + + + :return: The namespace of this PrivateEndpoint. + :rtype: str + """ + return self._namespace + + @namespace.setter + def namespace(self, namespace): + """ + Sets the namespace of this PrivateEndpoint. + The Object Storage namespace associated with the private enpoint. + + + :param namespace: The namespace of this PrivateEndpoint. + :type: str + """ + self._namespace = namespace + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this PrivateEndpoint. + The compartment which is associated with the Private Endpoint. + + + :return: The compartment_id of this PrivateEndpoint. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this PrivateEndpoint. + The compartment which is associated with the Private Endpoint. + + + :param compartment_id: The compartment_id of this PrivateEndpoint. + :type: str + """ + self._compartment_id = compartment_id + + @property + def created_by(self): + """ + **[Required]** Gets the created_by of this PrivateEndpoint. + The `OCID`__ of the user who created the Private Endpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The created_by of this PrivateEndpoint. + :rtype: str + """ + return self._created_by + + @created_by.setter + def created_by(self, created_by): + """ + Sets the created_by of this PrivateEndpoint. + The `OCID`__ of the user who created the Private Endpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param created_by: The created_by of this PrivateEndpoint. + :type: str + """ + self._created_by = created_by + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this PrivateEndpoint. + The date and time the Private Endpoint was created, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :return: The time_created of this PrivateEndpoint. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this PrivateEndpoint. + The date and time the Private Endpoint was created, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :param time_created: The time_created of this PrivateEndpoint. + :type: datetime + """ + self._time_created = time_created + + @property + def time_modified(self): + """ + **[Required]** Gets the time_modified of this PrivateEndpoint. + The date and time the Private Endpoint was updated, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :return: The time_modified of this PrivateEndpoint. + :rtype: datetime + """ + return self._time_modified + + @time_modified.setter + def time_modified(self, time_modified): + """ + Sets the time_modified of this PrivateEndpoint. + The date and time the Private Endpoint was updated, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :param time_modified: The time_modified of this PrivateEndpoint. + :type: datetime + """ + self._time_modified = time_modified + + @property + def subnet_id(self): + """ + **[Required]** Gets the subnet_id of this PrivateEndpoint. + The OCID of the customer's subnet where the private endpoint VNIC will reside. + + + :return: The subnet_id of this PrivateEndpoint. + :rtype: str + """ + return self._subnet_id + + @subnet_id.setter + def subnet_id(self, subnet_id): + """ + Sets the subnet_id of this PrivateEndpoint. + The OCID of the customer's subnet where the private endpoint VNIC will reside. + + + :param subnet_id: The subnet_id of this PrivateEndpoint. + :type: str + """ + self._subnet_id = subnet_id + + @property + def private_endpoint_ip(self): + """ + **[Required]** Gets the private_endpoint_ip of this PrivateEndpoint. + The private IP address to assign to this private endpoint. If you provide a value, + it must be an available IP address in the customer's subnet. If it's not available, an error + is returned. + + If you do not provide a value, an available IP address in the subnet is automatically chosen. + + + :return: The private_endpoint_ip of this PrivateEndpoint. + :rtype: str + """ + return self._private_endpoint_ip + + @private_endpoint_ip.setter + def private_endpoint_ip(self, private_endpoint_ip): + """ + Sets the private_endpoint_ip of this PrivateEndpoint. + The private IP address to assign to this private endpoint. If you provide a value, + it must be an available IP address in the customer's subnet. If it's not available, an error + is returned. + + If you do not provide a value, an available IP address in the subnet is automatically chosen. + + + :param private_endpoint_ip: The private_endpoint_ip of this PrivateEndpoint. + :type: str + """ + self._private_endpoint_ip = private_endpoint_ip + + @property + def prefix(self): + """ + **[Required]** Gets the prefix of this PrivateEndpoint. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :return: The prefix of this PrivateEndpoint. + :rtype: str + """ + return self._prefix + + @prefix.setter + def prefix(self, prefix): + """ + Sets the prefix of this PrivateEndpoint. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :param prefix: The prefix of this PrivateEndpoint. + :type: str + """ + self._prefix = prefix + + @property + def additional_prefixes(self): + """ + Gets the additional_prefixes of this PrivateEndpoint. + A list of additional prefix that you can provide along with any other prefix. These resulting endpointFqdn's are added to the + customer VCN's DNS record. + + + :return: The additional_prefixes of this PrivateEndpoint. + :rtype: list[str] + """ + return self._additional_prefixes + + @additional_prefixes.setter + def additional_prefixes(self, additional_prefixes): + """ + Sets the additional_prefixes of this PrivateEndpoint. + A list of additional prefix that you can provide along with any other prefix. These resulting endpointFqdn's are added to the + customer VCN's DNS record. + + + :param additional_prefixes: The additional_prefixes of this PrivateEndpoint. + :type: list[str] + """ + self._additional_prefixes = additional_prefixes + + @property + def nsg_ids(self): + """ + Gets the nsg_ids of this PrivateEndpoint. + A list of the OCIDs of the network security groups (NSGs) to add the private endpoint's VNIC to. + For more information about NSGs, see + :class:`NetworkSecurityGroup`. + + + :return: The nsg_ids of this PrivateEndpoint. + :rtype: list[str] + """ + return self._nsg_ids + + @nsg_ids.setter + def nsg_ids(self, nsg_ids): + """ + Sets the nsg_ids of this PrivateEndpoint. + A list of the OCIDs of the network security groups (NSGs) to add the private endpoint's VNIC to. + For more information about NSGs, see + :class:`NetworkSecurityGroup`. + + + :param nsg_ids: The nsg_ids of this PrivateEndpoint. + :type: list[str] + """ + self._nsg_ids = nsg_ids + + @property + def fqdns(self): + """ + **[Required]** Gets the fqdns of this PrivateEndpoint. + + :return: The fqdns of this PrivateEndpoint. + :rtype: oci.object_storage.models.Fqdns + """ + return self._fqdns + + @fqdns.setter + def fqdns(self, fqdns): + """ + Sets the fqdns of this PrivateEndpoint. + + :param fqdns: The fqdns of this PrivateEndpoint. + :type: oci.object_storage.models.Fqdns + """ + self._fqdns = fqdns + + @property + def etag(self): + """ + **[Required]** Gets the etag of this PrivateEndpoint. + The entity tag (ETag) for the Private Endpoint. + + + :return: The etag of this PrivateEndpoint. + :rtype: str + """ + return self._etag + + @etag.setter + def etag(self, etag): + """ + Sets the etag of this PrivateEndpoint. + The entity tag (ETag) for the Private Endpoint. + + + :param etag: The etag of this PrivateEndpoint. + :type: str + """ + self._etag = etag + + @property + def lifecycle_state(self): + """ + Gets the lifecycle_state of this PrivateEndpoint. + The Private Endpoint's lifecycle state. + + Allowed values for this property are: "CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED", 'UNKNOWN_ENUM_VALUE'. + Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. + + + :return: The lifecycle_state of this PrivateEndpoint. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this PrivateEndpoint. + The Private Endpoint's lifecycle state. + + + :param lifecycle_state: The lifecycle_state of this PrivateEndpoint. + :type: str + """ + allowed_values = ["CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "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 access_targets(self): + """ + **[Required]** Gets the access_targets of this PrivateEndpoint. + A list of targets that can be accessed by the private endpoint. At least one or more access targets is required for a private endpoint. + + + :return: The access_targets of this PrivateEndpoint. + :rtype: list[oci.object_storage.models.AccessTargetDetails] + """ + return self._access_targets + + @access_targets.setter + def access_targets(self, access_targets): + """ + Sets the access_targets of this PrivateEndpoint. + A list of targets that can be accessed by the private endpoint. At least one or more access targets is required for a private endpoint. + + + :param access_targets: The access_targets of this PrivateEndpoint. + :type: list[oci.object_storage.models.AccessTargetDetails] + """ + self._access_targets = access_targets + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this PrivateEndpoint. + 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 PrivateEndpoint. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this PrivateEndpoint. + 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 PrivateEndpoint. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this PrivateEndpoint. + 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/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this PrivateEndpoint. + :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 PrivateEndpoint. + 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/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this PrivateEndpoint. + :type: dict(str, dict(str, object)) + """ + self._defined_tags = defined_tags + + @property + def id(self): + """ + Gets the id of this PrivateEndpoint. + The `OCID`__ of the PrivateEndpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The id of this PrivateEndpoint. + :rtype: str + """ + return self._id + + @id.setter + def id(self, id): + """ + Sets the id of this PrivateEndpoint. + The `OCID`__ of the PrivateEndpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param id: The id of this PrivateEndpoint. + :type: str + """ + self._id = 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/private_endpoint_summary.py b/src/oci/object_storage/models/private_endpoint_summary.py new file mode 100644 index 0000000000..5ccbf0b022 --- /dev/null +++ b/src/oci/object_storage/models/private_endpoint_summary.py @@ -0,0 +1,369 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 PrivateEndpointSummary(object): + """ + To use any of the API operations, you must be authorized in an IAM policy. If you are not authorized, + talk to an administrator. If you are an administrator who needs to write policies to give users access, see + `Getting Started with Policies`__. + + __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm + """ + + def __init__(self, **kwargs): + """ + Initializes a new PrivateEndpointSummary object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param name: + The value to assign to the name property of this PrivateEndpointSummary. + :type name: str + + :param namespace: + The value to assign to the namespace property of this PrivateEndpointSummary. + :type namespace: str + + :param compartment_id: + The value to assign to the compartment_id property of this PrivateEndpointSummary. + :type compartment_id: str + + :param created_by: + The value to assign to the created_by property of this PrivateEndpointSummary. + :type created_by: str + + :param time_created: + The value to assign to the time_created property of this PrivateEndpointSummary. + :type time_created: datetime + + :param time_modified: + The value to assign to the time_modified property of this PrivateEndpointSummary. + :type time_modified: datetime + + :param prefix: + The value to assign to the prefix property of this PrivateEndpointSummary. + :type prefix: str + + :param fqdns: + The value to assign to the fqdns property of this PrivateEndpointSummary. + :type fqdns: oci.object_storage.models.Fqdns + + :param etag: + The value to assign to the etag property of this PrivateEndpointSummary. + :type etag: str + + :param lifecycle_state: + The value to assign to the lifecycle_state property of this PrivateEndpointSummary. + :type lifecycle_state: str + + """ + self.swagger_types = { + 'name': 'str', + 'namespace': 'str', + 'compartment_id': 'str', + 'created_by': 'str', + 'time_created': 'datetime', + 'time_modified': 'datetime', + 'prefix': 'str', + 'fqdns': 'Fqdns', + 'etag': 'str', + 'lifecycle_state': 'str' + } + + self.attribute_map = { + 'name': 'name', + 'namespace': 'namespace', + 'compartment_id': 'compartmentId', + 'created_by': 'createdBy', + 'time_created': 'timeCreated', + 'time_modified': 'timeModified', + 'prefix': 'prefix', + 'fqdns': 'fqdns', + 'etag': 'etag', + 'lifecycle_state': 'lifecycleState' + } + + self._name = None + self._namespace = None + self._compartment_id = None + self._created_by = None + self._time_created = None + self._time_modified = None + self._prefix = None + self._fqdns = None + self._etag = None + self._lifecycle_state = None + + @property + def name(self): + """ + **[Required]** Gets the name of this PrivateEndpointSummary. + The name given to the Private Endpoint. Avoid entering confidential information. + Example: my-new-pe1 + + + :return: The name of this PrivateEndpointSummary. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this PrivateEndpointSummary. + The name given to the Private Endpoint. Avoid entering confidential information. + Example: my-new-pe1 + + + :param name: The name of this PrivateEndpointSummary. + :type: str + """ + self._name = name + + @property + def namespace(self): + """ + **[Required]** Gets the namespace of this PrivateEndpointSummary. + The Object Storage namespace with which the Private Endpoint is associated. + + + :return: The namespace of this PrivateEndpointSummary. + :rtype: str + """ + return self._namespace + + @namespace.setter + def namespace(self, namespace): + """ + Sets the namespace of this PrivateEndpointSummary. + The Object Storage namespace with which the Private Endpoint is associated. + + + :param namespace: The namespace of this PrivateEndpointSummary. + :type: str + """ + self._namespace = namespace + + @property + def compartment_id(self): + """ + **[Required]** Gets the compartment_id of this PrivateEndpointSummary. + The compartment ID in which the Private Endpoint is authorized. + + + :return: The compartment_id of this PrivateEndpointSummary. + :rtype: str + """ + return self._compartment_id + + @compartment_id.setter + def compartment_id(self, compartment_id): + """ + Sets the compartment_id of this PrivateEndpointSummary. + The compartment ID in which the Private Endpoint is authorized. + + + :param compartment_id: The compartment_id of this PrivateEndpointSummary. + :type: str + """ + self._compartment_id = compartment_id + + @property + def created_by(self): + """ + **[Required]** Gets the created_by of this PrivateEndpointSummary. + The `OCID`__ of the user who created the Private Endpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :return: The created_by of this PrivateEndpointSummary. + :rtype: str + """ + return self._created_by + + @created_by.setter + def created_by(self, created_by): + """ + Sets the created_by of this PrivateEndpointSummary. + The `OCID`__ of the user who created the Private Endpoint. + + __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm + + + :param created_by: The created_by of this PrivateEndpointSummary. + :type: str + """ + self._created_by = created_by + + @property + def time_created(self): + """ + **[Required]** Gets the time_created of this PrivateEndpointSummary. + The date and time the Private Endpoint was created, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :return: The time_created of this PrivateEndpointSummary. + :rtype: datetime + """ + return self._time_created + + @time_created.setter + def time_created(self, time_created): + """ + Sets the time_created of this PrivateEndpointSummary. + The date and time the Private Endpoint was created, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :param time_created: The time_created of this PrivateEndpointSummary. + :type: datetime + """ + self._time_created = time_created + + @property + def time_modified(self): + """ + **[Required]** Gets the time_modified of this PrivateEndpointSummary. + The date and time the Private Endpoint was updated, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :return: The time_modified of this PrivateEndpointSummary. + :rtype: datetime + """ + return self._time_modified + + @time_modified.setter + def time_modified(self, time_modified): + """ + Sets the time_modified of this PrivateEndpointSummary. + The date and time the Private Endpoint was updated, as described in `RFC 2616`__. + + __ https://tools.ietf.org/html/rfc2616#section-14.29 + + + :param time_modified: The time_modified of this PrivateEndpointSummary. + :type: datetime + """ + self._time_modified = time_modified + + @property + def prefix(self): + """ + **[Required]** Gets the prefix of this PrivateEndpointSummary. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :return: The prefix of this PrivateEndpointSummary. + :rtype: str + """ + return self._prefix + + @prefix.setter + def prefix(self, prefix): + """ + Sets the prefix of this PrivateEndpointSummary. + A prefix to use for the private endpoint. The customer VCN's DNS records are + updated with this prefix. The prefix input from the customer will be the first sub-domain in the endpointFqdn. + Example: If the prefix chosen is \"abc\", then the endpointFqdn will be 'abc.private.objectstorage..oraclecloud.com' + + + :param prefix: The prefix of this PrivateEndpointSummary. + :type: str + """ + self._prefix = prefix + + @property + def fqdns(self): + """ + **[Required]** Gets the fqdns of this PrivateEndpointSummary. + + :return: The fqdns of this PrivateEndpointSummary. + :rtype: oci.object_storage.models.Fqdns + """ + return self._fqdns + + @fqdns.setter + def fqdns(self, fqdns): + """ + Sets the fqdns of this PrivateEndpointSummary. + + :param fqdns: The fqdns of this PrivateEndpointSummary. + :type: oci.object_storage.models.Fqdns + """ + self._fqdns = fqdns + + @property + def etag(self): + """ + **[Required]** Gets the etag of this PrivateEndpointSummary. + The entity tag for the Private Endpoint. + + + :return: The etag of this PrivateEndpointSummary. + :rtype: str + """ + return self._etag + + @etag.setter + def etag(self, etag): + """ + Sets the etag of this PrivateEndpointSummary. + The entity tag for the Private Endpoint. + + + :param etag: The etag of this PrivateEndpointSummary. + :type: str + """ + self._etag = etag + + @property + def lifecycle_state(self): + """ + **[Required]** Gets the lifecycle_state of this PrivateEndpointSummary. + The summaries of Private Endpoints' lifecycle state. + + + :return: The lifecycle_state of this PrivateEndpointSummary. + :rtype: str + """ + return self._lifecycle_state + + @lifecycle_state.setter + def lifecycle_state(self, lifecycle_state): + """ + Sets the lifecycle_state of this PrivateEndpointSummary. + The summaries of Private Endpoints' lifecycle state. + + + :param lifecycle_state: The lifecycle_state of this PrivateEndpointSummary. + :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/object_storage/models/update_private_endpoint_details.py b/src/oci/object_storage/models/update_private_endpoint_details.py new file mode 100644 index 0000000000..f1b0094188 --- /dev/null +++ b/src/oci/object_storage/models/update_private_endpoint_details.py @@ -0,0 +1,216 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20160918 + + +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 UpdatePrivateEndpointDetails(object): + """ + Information that can be updated for a private endpoint. + """ + + def __init__(self, **kwargs): + """ + Initializes a new UpdatePrivateEndpointDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param name: + The value to assign to the name property of this UpdatePrivateEndpointDetails. + :type name: str + + :param namespace: + The value to assign to the namespace property of this UpdatePrivateEndpointDetails. + :type namespace: str + + :param access_targets: + The value to assign to the access_targets property of this UpdatePrivateEndpointDetails. + :type access_targets: list[oci.object_storage.models.AccessTargetDetails] + + :param freeform_tags: + The value to assign to the freeform_tags property of this UpdatePrivateEndpointDetails. + :type freeform_tags: dict(str, str) + + :param defined_tags: + The value to assign to the defined_tags property of this UpdatePrivateEndpointDetails. + :type defined_tags: dict(str, dict(str, object)) + + """ + self.swagger_types = { + 'name': 'str', + 'namespace': 'str', + 'access_targets': 'list[AccessTargetDetails]', + 'freeform_tags': 'dict(str, str)', + 'defined_tags': 'dict(str, dict(str, object))' + } + + self.attribute_map = { + 'name': 'name', + 'namespace': 'namespace', + 'access_targets': 'accessTargets', + 'freeform_tags': 'freeformTags', + 'defined_tags': 'definedTags' + } + + self._name = None + self._namespace = None + self._access_targets = None + self._freeform_tags = None + self._defined_tags = None + + @property + def name(self): + """ + Gets the name of this UpdatePrivateEndpointDetails. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :return: The name of this UpdatePrivateEndpointDetails. + :rtype: str + """ + return self._name + + @name.setter + def name(self, name): + """ + Sets the name of this UpdatePrivateEndpointDetails. + This name associated with the endpoint. Valid characters are uppercase or lowercase letters, numbers, hyphens, + underscores, and periods. + Example: my-new-private-endpoint1 + + + :param name: The name of this UpdatePrivateEndpointDetails. + :type: str + """ + self._name = name + + @property + def namespace(self): + """ + Gets the namespace of this UpdatePrivateEndpointDetails. + The Object Storage namespace which will associated with the private endpoint. + + + :return: The namespace of this UpdatePrivateEndpointDetails. + :rtype: str + """ + return self._namespace + + @namespace.setter + def namespace(self, namespace): + """ + Sets the namespace of this UpdatePrivateEndpointDetails. + The Object Storage namespace which will associated with the private endpoint. + + + :param namespace: The namespace of this UpdatePrivateEndpointDetails. + :type: str + """ + self._namespace = namespace + + @property + def access_targets(self): + """ + Gets the access_targets of this UpdatePrivateEndpointDetails. + A list of targets that can be accessed by the private endpoint. + + + :return: The access_targets of this UpdatePrivateEndpointDetails. + :rtype: list[oci.object_storage.models.AccessTargetDetails] + """ + return self._access_targets + + @access_targets.setter + def access_targets(self, access_targets): + """ + Sets the access_targets of this UpdatePrivateEndpointDetails. + A list of targets that can be accessed by the private endpoint. + + + :param access_targets: The access_targets of this UpdatePrivateEndpointDetails. + :type: list[oci.object_storage.models.AccessTargetDetails] + """ + self._access_targets = access_targets + + @property + def freeform_tags(self): + """ + Gets the freeform_tags of this UpdatePrivateEndpointDetails. + 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 UpdatePrivateEndpointDetails. + :rtype: dict(str, str) + """ + return self._freeform_tags + + @freeform_tags.setter + def freeform_tags(self, freeform_tags): + """ + Sets the freeform_tags of this UpdatePrivateEndpointDetails. + 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 UpdatePrivateEndpointDetails. + :type: dict(str, str) + """ + self._freeform_tags = freeform_tags + + @property + def defined_tags(self): + """ + Gets the defined_tags of this UpdatePrivateEndpointDetails. + 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/Content/General/Concepts/resourcetags.htm + + + :return: The defined_tags of this UpdatePrivateEndpointDetails. + :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 UpdatePrivateEndpointDetails. + 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/Content/General/Concepts/resourcetags.htm + + + :param defined_tags: The defined_tags of this UpdatePrivateEndpointDetails. + :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/object_storage/models/work_request.py b/src/oci/object_storage/models/work_request.py index 5c63693254..20c55e4f6c 100644 --- a/src/oci/object_storage/models/work_request.py +++ b/src/oci/object_storage/models/work_request.py @@ -23,6 +23,18 @@ class WorkRequest(object): #: This constant has a value of "REENCRYPT" OPERATION_TYPE_REENCRYPT = "REENCRYPT" + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "PRIVATE_ENDPOINT_CREATE" + OPERATION_TYPE_PRIVATE_ENDPOINT_CREATE = "PRIVATE_ENDPOINT_CREATE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "PRIVATE_ENDPOINT_UPDATE" + OPERATION_TYPE_PRIVATE_ENDPOINT_UPDATE = "PRIVATE_ENDPOINT_UPDATE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "PRIVATE_ENDPOINT_DELETE" + OPERATION_TYPE_PRIVATE_ENDPOINT_DELETE = "PRIVATE_ENDPOINT_DELETE" + #: A constant which can be used with the status property of a WorkRequest. #: This constant has a value of "ACCEPTED" STATUS_ACCEPTED = "ACCEPTED" @@ -54,7 +66,7 @@ def __init__(self, **kwargs): :param operation_type: The value to assign to the operation_type property of this WorkRequest. - Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type operation_type: str @@ -133,7 +145,7 @@ def operation_type(self): Gets the operation_type of this WorkRequest. The type of work request. - Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -152,7 +164,7 @@ def operation_type(self, operation_type): :param operation_type: The operation_type of this WorkRequest. :type: str """ - allowed_values = ["COPY_OBJECT", "REENCRYPT"] + allowed_values = ["COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE"] if not value_allowed_none_or_none_sentinel(operation_type, allowed_values): operation_type = 'UNKNOWN_ENUM_VALUE' self._operation_type = operation_type diff --git a/src/oci/object_storage/models/work_request_summary.py b/src/oci/object_storage/models/work_request_summary.py index 7faa76a09d..c80f38e139 100644 --- a/src/oci/object_storage/models/work_request_summary.py +++ b/src/oci/object_storage/models/work_request_summary.py @@ -23,6 +23,18 @@ class WorkRequestSummary(object): #: This constant has a value of "REENCRYPT" OPERATION_TYPE_REENCRYPT = "REENCRYPT" + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "PRIVATE_ENDPOINT_CREATE" + OPERATION_TYPE_PRIVATE_ENDPOINT_CREATE = "PRIVATE_ENDPOINT_CREATE" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "PRIVATE_ENDPOINT_UPDATE" + OPERATION_TYPE_PRIVATE_ENDPOINT_UPDATE = "PRIVATE_ENDPOINT_UPDATE" + + #: A constant which can be used with the operation_type property of a WorkRequestSummary. + #: This constant has a value of "PRIVATE_ENDPOINT_DELETE" + OPERATION_TYPE_PRIVATE_ENDPOINT_DELETE = "PRIVATE_ENDPOINT_DELETE" + #: A constant which can be used with the status property of a WorkRequestSummary. #: This constant has a value of "ACCEPTED" STATUS_ACCEPTED = "ACCEPTED" @@ -54,7 +66,7 @@ def __init__(self, **kwargs): :param operation_type: The value to assign to the operation_type property of this WorkRequestSummary. - Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type operation_type: str @@ -133,7 +145,7 @@ def operation_type(self): Gets the operation_type of this WorkRequestSummary. The type of work request. - Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -152,7 +164,7 @@ def operation_type(self, operation_type): :param operation_type: The operation_type of this WorkRequestSummary. :type: str """ - allowed_values = ["COPY_OBJECT", "REENCRYPT"] + allowed_values = ["COPY_OBJECT", "REENCRYPT", "PRIVATE_ENDPOINT_CREATE", "PRIVATE_ENDPOINT_UPDATE", "PRIVATE_ENDPOINT_DELETE"] if not value_allowed_none_or_none_sentinel(operation_type, allowed_values): operation_type = 'UNKNOWN_ENUM_VALUE' self._operation_type = operation_type diff --git a/src/oci/object_storage/object_storage_client.py b/src/oci/object_storage/object_storage_client.py index f5472225cb..0daed6ef73 100644 --- a/src/oci/object_storage/object_storage_client.py +++ b/src/oci/object_storage/object_storage_client.py @@ -1011,6 +1011,107 @@ def create_preauthenticated_request(self, namespace_name, bucket_name, create_pr api_reference_link=api_reference_link, required_arguments=required_arguments) + def create_private_endpoint(self, namespace_name, create_private_endpoint_details, **kwargs): + """ + Create a PrivateEndpoint. + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param oci.object_storage.models.CreatePrivateEndpointDetails create_private_endpoint_details: (required) + Details to create a private endpoint. + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_private_endpoint API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['namespaceName'] + resource_path = "/n/{namespaceName}/pe" + method = "POST" + operation_name = "create_private_endpoint" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PrivateEndpoint/CreatePrivateEndpoint" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"create_private_endpoint got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "namespaceName": namespace_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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=create_private_endpoint_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=create_private_endpoint_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def create_replication_policy(self, namespace_name, bucket_name, create_replication_policy_details, **kwargs): """ Creates a replication policy for the specified bucket. @@ -1677,6 +1778,114 @@ def delete_preauthenticated_request(self, namespace_name, bucket_name, par_id, * api_reference_link=api_reference_link, required_arguments=required_arguments) + def delete_private_endpoint(self, namespace_name, pe_name, **kwargs): + """ + Deletes a Private Endpoint if it exists in the given namespace. + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str pe_name: (required) + The name of the private endpoint. Avoid entering confidential information. + Example: `my-new-pe-1` + + :param str if_match: (optional) + 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. + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_private_endpoint API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['namespaceName', 'peName'] + resource_path = "/n/{namespaceName}/pe/{peName}" + method = "DELETE" + operation_name = "delete_private_endpoint" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PrivateEndpoint/DeletePrivateEndpoint" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "if_match", + "opc_client_request_id" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"delete_private_endpoint got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "namespaceName": namespace_name, + "peName": pe_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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def delete_replication_policy(self, namespace_name, bucket_name, replication_id, **kwargs): """ Deletes the replication policy associated with the source bucket. @@ -2576,34 +2785,149 @@ def get_preauthenticated_request(self, namespace_name, bucket_name, par_id, **kw allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. By default, the response will not allow control characters in strings - :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.PreauthenticatedRequestSummary` + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.PreauthenticatedRequestSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use get_preauthenticated_request API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['namespaceName', 'bucketName', 'parId'] + resource_path = "/n/{namespaceName}/b/{bucketName}/p/{parId}" + method = "GET" + operation_name = "get_preauthenticated_request" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/GetPreauthenticatedRequest" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"get_preauthenticated_request got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "namespaceName": namespace_name, + "bucketName": bucket_name, + "parId": par_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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="PreauthenticatedRequestSummary", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + response_type="PreauthenticatedRequestSummary", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + + def get_private_endpoint(self, namespace_name, pe_name, **kwargs): + """ + Gets the current representation of the given Private Endpoint in the given Object Storage namespace. + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str pe_name: (required) + The name of the private endpoint. Avoid entering confidential information. + Example: `my-new-pe-1` + + :param str if_match: (optional) + 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. Wildcards ('*') are not allowed. If the specified ETag does not + match the ETag of the existing resource, the request returns the expected response. If the ETag matches + the ETag of the existing resource, the request returns an HTTP 304 status without a response body. + + :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. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.object_storage.models.PrivateEndpoint` :rtype: :class:`~oci.response.Response` :example: - Click `here `__ to see an example of how to use get_preauthenticated_request API. + Click `here `__ to see an example of how to use get_private_endpoint API. """ # Required path and query arguments. These are in camelCase to replace values in service endpoints. - required_arguments = ['namespaceName', 'bucketName', 'parId'] - resource_path = "/n/{namespaceName}/b/{bucketName}/p/{parId}" + required_arguments = ['namespaceName', 'peName'] + resource_path = "/n/{namespaceName}/pe/{peName}" method = "GET" - operation_name = "get_preauthenticated_request" - api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PreauthenticatedRequest/GetPreauthenticatedRequest" + operation_name = "get_private_endpoint" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PrivateEndpoint/GetPrivateEndpoint" # Don't accept unknown kwargs expected_kwargs = [ "allow_control_chars", "retry_strategy", + "if_match", + "if_none_match", "opc_client_request_id" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: raise ValueError( - f"get_preauthenticated_request got unknown kwargs: {extra_kwargs!r}") + f"get_private_endpoint got unknown kwargs: {extra_kwargs!r}") path_params = { "namespaceName": namespace_name, - "bucketName": bucket_name, - "parId": par_id + "peName": pe_name } path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing} @@ -2615,6 +2939,8 @@ def get_preauthenticated_request(self, namespace_name, bucket_name, par_id, **kw header_params = { "accept": "application/json", "content-type": "application/json", + "if-match": kwargs.get("if_match", missing), + "if-none-match": kwargs.get("if_none_match", missing), "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} @@ -2636,7 +2962,7 @@ def get_preauthenticated_request(self, namespace_name, bucket_name, par_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="PreauthenticatedRequestSummary", + response_type="PrivateEndpoint", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -2647,7 +2973,7 @@ def get_preauthenticated_request(self, namespace_name, bucket_name, par_id, **kw method=method, path_params=path_params, header_params=header_params, - response_type="PreauthenticatedRequestSummary", + response_type="PrivateEndpoint", allow_control_chars=kwargs.get('allow_control_chars'), operation_name=operation_name, api_reference_link=api_reference_link, @@ -3674,10 +4000,10 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): The string to use for matching against the start of object names in a list query. :param str start: (optional) - Object names returned by a list query must be greater or equal to this parameter. + Returns object names which are lexicographically greater than or equal to this parameter. :param str end: (optional) - Object names returned by a list query must be strictly less than this parameter. + Returns object names which are lexicographically strictly less than this parameter. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated @@ -3706,7 +4032,7 @@ def list_object_versions(self, namespace_name, bucket_name, **kwargs): The client request ID for tracing. :param str start_after: (optional) - Object names returned by a list query must be greater than this parameter. + Returns object names which are lexicographically strictly greater than this parameter. :param str page: (optional) For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call. For important @@ -3851,10 +4177,10 @@ def list_objects(self, namespace_name, bucket_name, **kwargs): The string to use for matching against the start of object names in a list query. :param str start: (optional) - Object names returned by a list query must be greater or equal to this parameter. + Returns object names which are lexicographically greater than or equal to this parameter. :param str end: (optional) - Object names returned by a list query must be strictly less than this parameter. + Returns object names which are lexicographically strictly less than this parameter. :param int limit: (optional) For list pagination. The maximum number of results per page, or items to return in a paginated @@ -3883,7 +4209,7 @@ def list_objects(self, namespace_name, bucket_name, **kwargs): The client request ID for tracing. :param str start_after: (optional) - Object names returned by a list query must be greater than this parameter. + Returns object names which are lexicographically strictly greater than this parameter. :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. @@ -4124,6 +4450,168 @@ def list_preauthenticated_requests(self, namespace_name, bucket_name, **kwargs): api_reference_link=api_reference_link, required_arguments=required_arguments) + def list_private_endpoints(self, namespace_name, compartment_id, **kwargs): + """ + Gets a list of all PrivateEndpointSummary in a compartment associated with a namespace. + 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`__. + + __ https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str compartment_id: (required) + The ID of the compartment in which to list buckets. + + :param int limit: (optional) + 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) + 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) + PrivateEndpoint summary in list of PrivateEndpoints includes the 'namespace', 'name', 'compartmentId', + 'createdBy', 'timeCreated', 'timeModified' and 'etag' fields. + This parameter can also include 'tags' (freeformTags and definedTags). + The only supported value of this parameter is 'tags' for now. Example 'tags'. + + Allowed values are: "tags" + + :param str opc_client_request_id: (optional) + The client request ID for tracing. + + :param str lifecycle_state: (optional) + The lifecycle state of the Private Endpoint + + Allowed values are: "CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :return: A :class:`~oci.response.Response` object with data of type list of :class:`~oci.object_storage.models.PrivateEndpointSummary` + :rtype: :class:`~oci.response.Response` + + :example: + Click `here `__ to see an example of how to use list_private_endpoints API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['namespaceName', 'compartmentId'] + resource_path = "/n/{namespaceName}/pe" + method = "GET" + operation_name = "list_private_endpoints" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PrivateEndpointSummary/ListPrivateEndpoints" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "limit", + "page", + "fields", + "opc_client_request_id", + "lifecycle_state" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"list_private_endpoints got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "namespaceName": namespace_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(f'Parameter {k} cannot be None, whitespace or empty string') + + if 'fields' in kwargs: + fields_allowed_values = ["tags"] + for fields_item in kwargs['fields']: + if fields_item not in fields_allowed_values: + raise ValueError( + f"Invalid value for `fields`, must be one of { fields_allowed_values }" + ) + + if 'lifecycle_state' in kwargs: + lifecycle_state_allowed_values = ["CREATING", "ACTIVE", "INACTIVE", "UPDATING", "DELETING", "DELETED", "FAILED"] + if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values: + raise ValueError( + f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }" + ) + + query_params = { + "compartmentId": compartment_id, + "limit": kwargs.get("limit", missing), + "page": kwargs.get("page", missing), + "fields": self.base_client.generate_collection_format_param(kwargs.get("fields", missing), 'csv'), + "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} + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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[PrivateEndpointSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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[PrivateEndpointSummary]", + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def list_replication_policies(self, namespace_name, bucket_name, **kwargs): """ List the replication policies associated with a bucket. @@ -4738,6 +5226,9 @@ def list_work_requests(self, compartment_id, **kwargs): :param str compartment_id: (required) The ID of the compartment in which to list buckets. + :param str private_endpoint_name: (optional) + The name of the privateEndpoint for which to list work requests. + :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -4783,6 +5274,7 @@ def list_work_requests(self, compartment_id, **kwargs): expected_kwargs = [ "allow_control_chars", "retry_strategy", + "private_endpoint_name", "opc_client_request_id", "page", "limit" @@ -4794,6 +5286,7 @@ def list_work_requests(self, compartment_id, **kwargs): query_params = { "compartmentId": compartment_id, + "privateEndpointName": kwargs.get("private_endpoint_name", missing), "page": kwargs.get("page", missing), "limit": kwargs.get("limit", missing) } @@ -4994,7 +5487,7 @@ def put_object(self, namespace_name, bucket_name, object_name, put_object_body, The only allowed value for this parameter is \"100-Continue\" (case-insensitive). :param str content_md5: (optional) - The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object + The optional header that defines the base64-encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message: @@ -5705,8 +6198,8 @@ def rename_object(self, namespace_name, bucket_name, rename_object_details, **kw def restore_objects(self, namespace_name, bucket_name, restore_objects_details, **kwargs): """ - Restores one or more objects specified by the objectName parameter. - By default objects will be restored for 24 hours. Duration can be configured using the hours parameter. + Restores the object specified by the objectName parameter. + By default object will be restored for 24 hours. Duration can be configured using the hours parameter. :param str namespace_name: (required) @@ -5717,7 +6210,7 @@ def restore_objects(self, namespace_name, bucket_name, restore_objects_details, Example: `my-new-bucket1` :param oci.object_storage.models.RestoreObjectsDetails restore_objects_details: (required) - Request to restore objects. + Request to restore object. :param str opc_client_request_id: (optional) The client request ID for tracing. @@ -6146,6 +6639,128 @@ def update_object_storage_tier(self, namespace_name, bucket_name, update_object_ api_reference_link=api_reference_link, required_arguments=required_arguments) + def update_private_endpoint(self, namespace_name, pe_name, update_private_endpoint_details, **kwargs): + """ + Performs a partial or full update of a user-defined data associated with the Private Endpoint. + + Use UpdatePrivateEndpoint to move a Private Endpoint from one compartment to another within the same tenancy. Supply the compartmentID + of the compartment that you want to move the Private Endpoint to. Or use it to update the name, subnetId, endpointFqdn or privateEndpointIp or accessTargets of the Private Endpoint. + For more information about moving resources between compartments, see `Moving Resources to a Different Compartment`__. + + This API follows replace semantics (rather than merge semantics). That means if the body provides values for + parameters and the resource has exisiting ones, this operation will replace those existing values. + + __ https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes + + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str pe_name: (required) + The name of the private endpoint. Avoid entering confidential information. + Example: `my-new-pe-1` + + :param oci.object_storage.models.UpdatePrivateEndpointDetails update_private_endpoint_details: (required) + Request object for updating the Private Endpoint. + + :param str opc_client_request_id: (optional) + The client request ID for tracing. + + :param str if_match: (optional) + 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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_private_endpoint API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['namespaceName', 'peName'] + resource_path = "/n/{namespaceName}/pe/{peName}" + method = "POST" + operation_name = "update_private_endpoint" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/objectstorage/20160918/PrivateEndpoint/UpdatePrivateEndpoint" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "retry_strategy", + "opc_client_request_id", + "if_match" + ] + extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] + if extra_kwargs: + raise ValueError( + f"update_private_endpoint got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "namespaceName": namespace_name, + "peName": pe_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(f'Parameter {k} cannot be None, whitespace or empty string') + + header_params = { + "accept": "application/json", + "content-type": "application/json", + "opc-client-request-id": kwargs.get("opc_client_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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_private_endpoint_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=update_private_endpoint_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + 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. @@ -6311,7 +6926,7 @@ def upload_part(self, namespace_name, bucket_name, object_name, upload_id, uploa The only allowed value for this parameter is \"100-Continue\" (case-insensitive). :param str content_md5: (optional) - The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object + The optional header that defines the base64-encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message: diff --git a/src/oci/object_storage/object_storage_client_composite_operations.py b/src/oci/object_storage/object_storage_client_composite_operations.py index c28fcab656..b558717b89 100644 --- a/src/oci/object_storage/object_storage_client_composite_operations.py +++ b/src/oci/object_storage/object_storage_client_composite_operations.py @@ -71,6 +71,99 @@ def copy_object_and_wait_for_state(self, namespace_name, bucket_name, copy_objec except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def create_private_endpoint_and_wait_for_state(self, namespace_name, create_private_endpoint_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.object_storage.ObjectStorageClient.create_private_endpoint` and waits for the :py:class:`~oci.object_storage.models.WorkRequest` + to enter the given state(s). + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param oci.object_storage.models.CreatePrivateEndpointDetails create_private_endpoint_details: (required) + Details to create a private endpoint. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.object_storage.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.object_storage.ObjectStorageClient.create_private_endpoint` + + :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_private_endpoint(namespace_name, create_private_endpoint_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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_private_endpoint_and_wait_for_state(self, namespace_name, pe_name, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.object_storage.ObjectStorageClient.delete_private_endpoint` and waits for the :py:class:`~oci.object_storage.models.WorkRequest` + to enter the given state(s). + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str pe_name: (required) + The name of the private endpoint. Avoid entering confidential information. + Example: `my-new-pe-1` + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.object_storage.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.object_storage.ObjectStorageClient.delete_private_endpoint` + + :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 = None + try: + operation_result = self.client.delete_private_endpoint(namespace_name, pe_name, **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] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 reencrypt_bucket_and_wait_for_state(self, namespace_name, bucket_name, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.object_storage.ObjectStorageClient.reencrypt_bucket` and waits for the :py:class:`~oci.object_storage.models.WorkRequest` @@ -113,3 +206,49 @@ def reencrypt_bucket_and_wait_for_state(self, namespace_name, bucket_name, wait_ return result_to_return except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + + def update_private_endpoint_and_wait_for_state(self, namespace_name, pe_name, update_private_endpoint_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.object_storage.ObjectStorageClient.update_private_endpoint` and waits for the :py:class:`~oci.object_storage.models.WorkRequest` + to enter the given state(s). + + :param str namespace_name: (required) + The Object Storage namespace used for the request. + + :param str pe_name: (required) + The name of the private endpoint. Avoid entering confidential information. + Example: `my-new-pe-1` + + :param oci.object_storage.models.UpdatePrivateEndpointDetails update_private_endpoint_details: (required) + Request object for updating the Private Endpoint. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.object_storage.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.object_storage.ObjectStorageClient.update_private_endpoint` + + :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_private_endpoint(namespace_name, pe_name, update_private_endpoint_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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/ocvp/cluster_client.py b/src/oci/ocvp/cluster_client.py index 3cc64a50f0..8ffd1ebaa4 100644 --- a/src/oci/ocvp/cluster_client.py +++ b/src/oci/ocvp/cluster_client.py @@ -232,7 +232,7 @@ def delete_cluster(self, cluster_id, **kwargs): :param str cluster_id: (required) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -340,7 +340,7 @@ def get_cluster(self, cluster_id, **kwargs): :param str cluster_id: (required) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -622,7 +622,7 @@ def update_cluster(self, cluster_id, update_cluster_details, **kwargs): :param str cluster_id: (required) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm diff --git a/src/oci/ocvp/cluster_client_composite_operations.py b/src/oci/ocvp/cluster_client_composite_operations.py index 30fa5b6822..d4c84459ab 100644 --- a/src/oci/ocvp/cluster_client_composite_operations.py +++ b/src/oci/ocvp/cluster_client_composite_operations.py @@ -70,7 +70,7 @@ def delete_cluster_and_wait_for_state(self, cluster_id, wait_for_states=[], oper to enter the given state(s). :param str cluster_id: (required) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm @@ -119,7 +119,7 @@ def update_cluster_and_wait_for_state(self, cluster_id, update_cluster_details, to enter the given state(s). :param str cluster_id: (required) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm diff --git a/src/oci/ocvp/esxi_host_client.py b/src/oci/ocvp/esxi_host_client.py index a1324ca7a2..5a286d13d8 100644 --- a/src/oci/ocvp/esxi_host_client.py +++ b/src/oci/ocvp/esxi_host_client.py @@ -578,7 +578,7 @@ def list_esxi_hosts(self, **kwargs): __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm :param str cluster_id: (optional) - The `OCID`__ of the Cluster. + The `OCID`__ of the SDDC Cluster. __ https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm diff --git a/src/oci/ocvp/models/cluster.py b/src/oci/ocvp/models/cluster.py index e86350f49d..9081656e96 100644 --- a/src/oci/ocvp/models/cluster.py +++ b/src/oci/ocvp/models/cluster.py @@ -184,6 +184,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this Cluster. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this Cluster. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -210,7 +214,8 @@ def __init__(self, **kwargs): 'datastores': 'list[DatastoreDetails]', 'vsphere_type': 'str', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -238,7 +243,8 @@ def __init__(self, **kwargs): 'datastores': 'datastores', 'vsphere_type': 'vsphereType', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -266,6 +272,7 @@ def __init__(self, **kwargs): self._vsphere_type = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -1013,6 +1020,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this Cluster. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this Cluster. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this Cluster. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this Cluster. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/cluster_summary.py b/src/oci/ocvp/models/cluster_summary.py index 835b2b2012..4c564759d9 100644 --- a/src/oci/ocvp/models/cluster_summary.py +++ b/src/oci/ocvp/models/cluster_summary.py @@ -120,6 +120,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this ClusterSummary. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this ClusterSummary. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -137,7 +141,8 @@ def __init__(self, **kwargs): 'initial_host_ocpu_count': 'float', 'vsphere_type': 'str', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -156,7 +161,8 @@ def __init__(self, **kwargs): 'initial_host_ocpu_count': 'initialHostOcpuCount', 'vsphere_type': 'vsphereType', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -175,6 +181,7 @@ def __init__(self, **kwargs): self._vsphere_type = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -658,6 +665,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this ClusterSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this ClusterSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this ClusterSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this ClusterSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/datastore_details.py b/src/oci/ocvp/models/datastore_details.py index 72bcbb26e6..649975501b 100644 --- a/src/oci/ocvp/models/datastore_details.py +++ b/src/oci/ocvp/models/datastore_details.py @@ -12,7 +12,7 @@ @init_model_state_from_kwargs class DatastoreDetails(object): """ - Datastore summary for a getting an Sddc. + Datastore details for a getting an Sddc. """ #: A constant which can be used with the datastore_type property of a DatastoreDetails. diff --git a/src/oci/ocvp/models/esxi_host.py b/src/oci/ocvp/models/esxi_host.py index 3774a4aecb..89ad52ce30 100644 --- a/src/oci/ocvp/models/esxi_host.py +++ b/src/oci/ocvp/models/esxi_host.py @@ -205,6 +205,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this EsxiHost. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this EsxiHost. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -235,7 +239,8 @@ def __init__(self, **kwargs): 'host_ocpu_count': 'float', 'capacity_reservation_id': 'str', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -267,7 +272,8 @@ def __init__(self, **kwargs): 'host_ocpu_count': 'hostOcpuCount', 'capacity_reservation_id': 'capacityReservationId', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -299,6 +305,7 @@ def __init__(self, **kwargs): self._capacity_reservation_id = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -1136,6 +1143,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this EsxiHost. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this EsxiHost. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this EsxiHost. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this EsxiHost. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/esxi_host_summary.py b/src/oci/ocvp/models/esxi_host_summary.py index 529fc97c36..339d3d30b6 100644 --- a/src/oci/ocvp/models/esxi_host_summary.py +++ b/src/oci/ocvp/models/esxi_host_summary.py @@ -190,6 +190,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this EsxiHostSummary. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this EsxiHostSummary. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -218,7 +222,8 @@ def __init__(self, **kwargs): 'is_billing_continuation_in_progress': 'bool', 'is_billing_swapping_in_progress': 'bool', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -248,7 +253,8 @@ def __init__(self, **kwargs): 'is_billing_continuation_in_progress': 'isBillingContinuationInProgress', 'is_billing_swapping_in_progress': 'isBillingSwappingInProgress', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -278,6 +284,7 @@ def __init__(self, **kwargs): self._is_billing_swapping_in_progress = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -1063,6 +1070,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this EsxiHostSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this EsxiHostSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this EsxiHostSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this EsxiHostSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/sddc.py b/src/oci/ocvp/models/sddc.py index 43281a059b..fe43223775 100644 --- a/src/oci/ocvp/models/sddc.py +++ b/src/oci/ocvp/models/sddc.py @@ -182,6 +182,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this Sddc. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this Sddc. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -211,7 +215,8 @@ def __init__(self, **kwargs): 'time_updated': 'datetime', 'lifecycle_state': 'str', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -242,7 +247,8 @@ def __init__(self, **kwargs): 'time_updated': 'timeUpdated', 'lifecycle_state': 'lifecycleState', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -273,6 +279,7 @@ def __init__(self, **kwargs): self._lifecycle_state = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -1150,6 +1157,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this Sddc. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this Sddc. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this Sddc. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this Sddc. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/sddc_summary.py b/src/oci/ocvp/models/sddc_summary.py index 88adc05db9..bed9502c36 100644 --- a/src/oci/ocvp/models/sddc_summary.py +++ b/src/oci/ocvp/models/sddc_summary.py @@ -120,6 +120,10 @@ def __init__(self, **kwargs): The value to assign to the defined_tags property of this SddcSummary. :type defined_tags: dict(str, dict(str, object)) + :param system_tags: + The value to assign to the system_tags property of this SddcSummary. + :type system_tags: dict(str, dict(str, object)) + """ self.swagger_types = { 'id': 'str', @@ -136,7 +140,8 @@ def __init__(self, **kwargs): 'lifecycle_state': 'str', 'is_single_host_sddc': 'bool', 'freeform_tags': 'dict(str, str)', - 'defined_tags': 'dict(str, dict(str, object))' + 'defined_tags': 'dict(str, dict(str, object))', + 'system_tags': 'dict(str, dict(str, object))' } self.attribute_map = { @@ -154,7 +159,8 @@ def __init__(self, **kwargs): 'lifecycle_state': 'lifecycleState', 'is_single_host_sddc': 'isSingleHostSddc', 'freeform_tags': 'freeformTags', - 'defined_tags': 'definedTags' + 'defined_tags': 'definedTags', + 'system_tags': 'systemTags' } self._id = None @@ -172,6 +178,7 @@ def __init__(self, **kwargs): self._is_single_host_sddc = None self._freeform_tags = None self._defined_tags = None + self._system_tags = None @property def id(self): @@ -631,6 +638,32 @@ def defined_tags(self, defined_tags): """ self._defined_tags = defined_tags + @property + def system_tags(self): + """ + Gets the system_tags of this SddcSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :return: The system_tags of this SddcSummary. + :rtype: dict(str, dict(str, object)) + """ + return self._system_tags + + @system_tags.setter + def system_tags(self, system_tags): + """ + Sets the system_tags of this SddcSummary. + Usage of system tag keys. These predefined keys are scoped to namespaces. + Example: `{orcl-cloud: {free-tier-retain: true}}` + + + :param system_tags: The system_tags of this SddcSummary. + :type: dict(str, dict(str, object)) + """ + self._system_tags = system_tags + def __repr__(self): return formatted_flat_dict(self) diff --git a/src/oci/ocvp/models/supported_host_shape_summary.py b/src/oci/ocvp/models/supported_host_shape_summary.py index d6f5415e15..3f6d9f8494 100644 --- a/src/oci/ocvp/models/supported_host_shape_summary.py +++ b/src/oci/ocvp/models/supported_host_shape_summary.py @@ -67,6 +67,58 @@ class SupportedHostShapeSummary(object): #: This constant has a value of "IN_PLACE_UPGRADE" SUPPORTED_OPERATIONS_IN_PLACE_UPGRADE = "IN_PLACE_UPGRADE" + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "CREATE_DATASTORE" + SUPPORTED_OPERATIONS_CREATE_DATASTORE = "CREATE_DATASTORE" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "UPDATE_DATASTORE" + SUPPORTED_OPERATIONS_UPDATE_DATASTORE = "UPDATE_DATASTORE" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "ADD_BLOCK_VOLUME_TO_DATASTORE" + SUPPORTED_OPERATIONS_ADD_BLOCK_VOLUME_TO_DATASTORE = "ADD_BLOCK_VOLUME_TO_DATASTORE" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "DELETE_DATASTORE" + SUPPORTED_OPERATIONS_DELETE_DATASTORE = "DELETE_DATASTORE" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "CREATE_DATASTORE_CLUSTER" + SUPPORTED_OPERATIONS_CREATE_DATASTORE_CLUSTER = "CREATE_DATASTORE_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "UPDATE_DATASTORE_CLUSTER" + SUPPORTED_OPERATIONS_UPDATE_DATASTORE_CLUSTER = "UPDATE_DATASTORE_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST" + SUPPORTED_OPERATIONS_ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST = "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER" + SUPPORTED_OPERATIONS_ATTACH_DATASTORE_CLUSTER_TO_CLUSTER = "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST" + SUPPORTED_OPERATIONS_DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST = "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER" + SUPPORTED_OPERATIONS_DETACH_DATASTORE_CLUSTER_FROM_CLUSTER = "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "DELETE_DATASTORE_CLUSTER" + SUPPORTED_OPERATIONS_DELETE_DATASTORE_CLUSTER = "DELETE_DATASTORE_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "ADD_DATASTORE_TO_DATASTORE_CLUSTER" + SUPPORTED_OPERATIONS_ADD_DATASTORE_TO_DATASTORE_CLUSTER = "ADD_DATASTORE_TO_DATASTORE_CLUSTER" + + #: A constant which can be used with the supported_operations property of a SupportedHostShapeSummary. + #: This constant has a value of "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER" + SUPPORTED_OPERATIONS_REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER = "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER" + def __init__(self, **kwargs): """ Initializes a new SupportedHostShapeSummary object with values from keyword arguments. @@ -78,7 +130,7 @@ def __init__(self, **kwargs): :param supported_operations: The value to assign to the supported_operations property of this SupportedHostShapeSummary. - Allowed values for items in this list are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type supported_operations: list[str] @@ -182,7 +234,7 @@ def supported_operations(self): **[Required]** Gets the supported_operations of this SupportedHostShapeSummary. The operations where you can use the shape. The operations can be CREATE_SDDC or CREATE_ESXI_HOST. - Allowed values for items in this list are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for items in this list are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -201,7 +253,7 @@ def supported_operations(self, supported_operations): :param supported_operations: The supported_operations of this SupportedHostShapeSummary. :type: list[str] """ - allowed_values = ["CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE"] + allowed_values = ["CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER"] if supported_operations: supported_operations[:] = ['UNKNOWN_ENUM_VALUE' if not value_allowed_none_or_none_sentinel(x, allowed_values) else x for x in supported_operations] self._supported_operations = supported_operations diff --git a/src/oci/ocvp/models/work_request.py b/src/oci/ocvp/models/work_request.py index 98b4b0118c..6b056d0bd6 100644 --- a/src/oci/ocvp/models/work_request.py +++ b/src/oci/ocvp/models/work_request.py @@ -67,6 +67,58 @@ class WorkRequest(object): #: This constant has a value of "IN_PLACE_UPGRADE" OPERATION_TYPE_IN_PLACE_UPGRADE = "IN_PLACE_UPGRADE" + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "CREATE_DATASTORE" + OPERATION_TYPE_CREATE_DATASTORE = "CREATE_DATASTORE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "UPDATE_DATASTORE" + OPERATION_TYPE_UPDATE_DATASTORE = "UPDATE_DATASTORE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "ADD_BLOCK_VOLUME_TO_DATASTORE" + OPERATION_TYPE_ADD_BLOCK_VOLUME_TO_DATASTORE = "ADD_BLOCK_VOLUME_TO_DATASTORE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DELETE_DATASTORE" + OPERATION_TYPE_DELETE_DATASTORE = "DELETE_DATASTORE" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "CREATE_DATASTORE_CLUSTER" + OPERATION_TYPE_CREATE_DATASTORE_CLUSTER = "CREATE_DATASTORE_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "UPDATE_DATASTORE_CLUSTER" + OPERATION_TYPE_UPDATE_DATASTORE_CLUSTER = "UPDATE_DATASTORE_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST" + OPERATION_TYPE_ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST = "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER" + OPERATION_TYPE_ATTACH_DATASTORE_CLUSTER_TO_CLUSTER = "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST" + OPERATION_TYPE_DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST = "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER" + OPERATION_TYPE_DETACH_DATASTORE_CLUSTER_FROM_CLUSTER = "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "DELETE_DATASTORE_CLUSTER" + OPERATION_TYPE_DELETE_DATASTORE_CLUSTER = "DELETE_DATASTORE_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "ADD_DATASTORE_TO_DATASTORE_CLUSTER" + OPERATION_TYPE_ADD_DATASTORE_TO_DATASTORE_CLUSTER = "ADD_DATASTORE_TO_DATASTORE_CLUSTER" + + #: A constant which can be used with the operation_type property of a WorkRequest. + #: This constant has a value of "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER" + OPERATION_TYPE_REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER = "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER" + #: A constant which can be used with the status property of a WorkRequest. #: This constant has a value of "ACCEPTED" STATUS_ACCEPTED = "ACCEPTED" @@ -98,7 +150,7 @@ def __init__(self, **kwargs): :param operation_type: The value to assign to the operation_type property of this WorkRequest. - Allowed values for this property are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type operation_type: str @@ -177,7 +229,7 @@ def operation_type(self): **[Required]** Gets the operation_type of this WorkRequest. The asynchronous operation tracked by this work request. - Allowed values for this property are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -196,7 +248,7 @@ def operation_type(self, operation_type): :param operation_type: The operation_type of this WorkRequest. :type: str """ - allowed_values = ["CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE"] + allowed_values = ["CREATE_SDDC", "DELETE_SDDC", "CREATE_CLUSTER", "DELETE_CLUSTER", "CREATE_ESXI_HOST", "DELETE_ESXI_HOST", "UPGRADE_HCX", "DOWNGRADE_HCX", "CANCEL_DOWNGRADE_HCX", "REFRESH_HCX_LICENSE_STATUS", "SWAP_BILLING", "REPLACE_HOST", "IN_PLACE_UPGRADE", "CREATE_DATASTORE", "UPDATE_DATASTORE", "ADD_BLOCK_VOLUME_TO_DATASTORE", "DELETE_DATASTORE", "CREATE_DATASTORE_CLUSTER", "UPDATE_DATASTORE_CLUSTER", "ATTACH_DATASTORE_CLUSTER_TO_ESXI_HOST", "ATTACH_DATASTORE_CLUSTER_TO_CLUSTER", "DETACH_DATASTORE_CLUSTER_FROM_ESXI_HOST", "DETACH_DATASTORE_CLUSTER_FROM_CLUSTER", "DELETE_DATASTORE_CLUSTER", "ADD_DATASTORE_TO_DATASTORE_CLUSTER", "REMOVE_DATASTORE_FROM_DATASTORE_CLUSTER"] if not value_allowed_none_or_none_sentinel(operation_type, allowed_values): operation_type = 'UNKNOWN_ENUM_VALUE' self._operation_type = operation_type diff --git a/src/oci/ocvp/sddc_client.py b/src/oci/ocvp/sddc_client.py index 3a0f82f03c..b650af90dd 100644 --- a/src/oci/ocvp/sddc_client.py +++ b/src/oci/ocvp/sddc_client.py @@ -1267,6 +1267,9 @@ def list_supported_vmware_software_versions(self, compartment_id, **kwargs): :param str host_shape_name: (optional) A filter to return only resources that match or support the given ESXi host shape. + :param str version_to_upgrade: (optional) + A filter to return only VMware software versions that the given VMware software version can be upgraded to. + :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. @@ -1300,7 +1303,8 @@ def list_supported_vmware_software_versions(self, compartment_id, **kwargs): "page", "opc_request_id", "version", - "host_shape_name" + "host_shape_name", + "version_to_upgrade" ] extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs] if extra_kwargs: @@ -1312,7 +1316,8 @@ def list_supported_vmware_software_versions(self, compartment_id, **kwargs): "limit": kwargs.get("limit", missing), "page": kwargs.get("page", missing), "version": kwargs.get("version", missing), - "hostShapeName": kwargs.get("host_shape_name", missing) + "hostShapeName": kwargs.get("host_shape_name", missing), + "versionToUpgrade": kwargs.get("version_to_upgrade", missing) } query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None} diff --git a/src/oci/recovery/database_recovery_client.py b/src/oci/recovery/database_recovery_client.py index c26e43d942..cc2b874b61 100644 --- a/src/oci/recovery/database_recovery_client.py +++ b/src/oci/recovery/database_recovery_client.py @@ -331,6 +331,116 @@ def change_protected_database_compartment(self, protected_database_id, change_pr api_reference_link=api_reference_link, required_arguments=required_arguments) + def change_protected_database_subscription(self, protected_database_id, change_protected_database_subscription_details, **kwargs): + """ + Associates the protected database with a new cloud service environment, such as Microsoft Azure. + + + :param str protected_database_id: (required) + The protected database OCID. + + :param oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails change_protected_database_subscription_details: (required) + Associate a protected database with a different subscription. + + :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. + + This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation uses :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` as default if no retry strategy is provided. + 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`. + + :param bool allow_control_chars: (optional) + allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object. + By default, the response will not allow control characters in strings + + :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_protected_database_subscription API. + """ + # Required path and query arguments. These are in camelCase to replace values in service endpoints. + required_arguments = ['protectedDatabaseId'] + resource_path = "/protectedDatabases/{protectedDatabaseId}/actions/changeSubscription" + method = "POST" + operation_name = "change_protected_database_subscription" + api_reference_link = "https://docs.oracle.com/iaas/api/#/en/recovery-service/20210216/ProtectedDatabase/ChangeProtectedDatabaseSubscription" + + # Don't accept unknown kwargs + expected_kwargs = [ + "allow_control_chars", + "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( + f"change_protected_database_subscription got unknown kwargs: {extra_kwargs!r}") + + path_params = { + "protectedDatabaseId": protected_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(f'Parameter {k} cannot be None, whitespace or empty string') + + 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.base_client.get_preferred_retry_strategy( + operation_retry_strategy=kwargs.get('retry_strategy'), + client_retry_strategy=self.retry_strategy + ) + if retry_strategy is None: + retry_strategy = retry.DEFAULT_RETRY_STRATEGY + + if retry_strategy: + if not isinstance(retry_strategy, retry.NoneRetryStrategy): + self.base_client.add_opc_client_retries_header(header_params) + retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback) + 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_protected_database_subscription_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + else: + return self.base_client.call_api( + resource_path=resource_path, + method=method, + path_params=path_params, + header_params=header_params, + body=change_protected_database_subscription_details, + allow_control_chars=kwargs.get('allow_control_chars'), + operation_name=operation_name, + api_reference_link=api_reference_link, + required_arguments=required_arguments) + def change_protection_policy_compartment(self, protection_policy_id, change_protection_policy_compartment_details, **kwargs): """ Moves a protection policy resource from the existing compartment to the specified compartment. When provided, If-Match is checked against ETag values of the resource. diff --git a/src/oci/recovery/database_recovery_client_composite_operations.py b/src/oci/recovery/database_recovery_client_composite_operations.py index c9f457fa7f..7a95213186 100644 --- a/src/oci/recovery/database_recovery_client_composite_operations.py +++ b/src/oci/recovery/database_recovery_client_composite_operations.py @@ -67,6 +67,48 @@ def change_protected_database_compartment_and_wait_for_state(self, protected_dat except Exception as e: raise oci.exceptions.CompositeOperationError(partial_results=[operation_result], cause=e) + def change_protected_database_subscription_and_wait_for_state(self, protected_database_id, change_protected_database_subscription_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): + """ + Calls :py:func:`~oci.recovery.DatabaseRecoveryClient.change_protected_database_subscription` and waits for the :py:class:`~oci.recovery.models.WorkRequest` + to enter the given state(s). + + :param str protected_database_id: (required) + The protected database OCID. + + :param oci.recovery.models.ChangeProtectedDatabaseSubscriptionDetails change_protected_database_subscription_details: (required) + Associate a protected database with a different subscription. + + :param list[str] wait_for_states: + An array of states to wait on. These should be valid values for :py:attr:`~oci.recovery.models.WorkRequest.status` + + :param dict operation_kwargs: + A dictionary of keyword arguments to pass to :py:func:`~oci.recovery.DatabaseRecoveryClient.change_protected_database_subscription` + + :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_protected_database_subscription(protected_database_id, change_protected_database_subscription_details, **operation_kwargs) + if not wait_for_states: + return operation_result + lowered_wait_for_states = [w.lower() for w in wait_for_states] + if 'opc-work-request-id' not in operation_result.headers: + return operation_result + wait_for_resource_id = operation_result.headers['opc-work-request-id'] + + try: + waiter_result = oci.wait_until( + self.client, + self.client.get_work_request(wait_for_resource_id), + evaluate_response=lambda r: getattr(r.data, 'status') and getattr(r.data, 'status').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 change_protection_policy_compartment_and_wait_for_state(self, protection_policy_id, change_protection_policy_compartment_details, wait_for_states=[], operation_kwargs={}, waiter_kwargs={}): """ Calls :py:func:`~oci.recovery.DatabaseRecoveryClient.change_protection_policy_compartment` and waits for the :py:class:`~oci.recovery.models.WorkRequest` diff --git a/src/oci/recovery/models/__init__.py b/src/oci/recovery/models/__init__.py index ed25249038..c3f8e33feb 100644 --- a/src/oci/recovery/models/__init__.py +++ b/src/oci/recovery/models/__init__.py @@ -7,6 +7,7 @@ from __future__ import absolute_import from .change_protected_database_compartment_details import ChangeProtectedDatabaseCompartmentDetails +from .change_protected_database_subscription_details import ChangeProtectedDatabaseSubscriptionDetails from .change_protection_policy_compartment_details import ChangeProtectionPolicyCompartmentDetails from .change_recovery_service_subnet_compartment_details import ChangeRecoveryServiceSubnetCompartmentDetails from .create_protected_database_details import CreateProtectedDatabaseDetails @@ -42,6 +43,7 @@ # Maps type names to classes for recovery services. recovery_type_mapping = { "ChangeProtectedDatabaseCompartmentDetails": ChangeProtectedDatabaseCompartmentDetails, + "ChangeProtectedDatabaseSubscriptionDetails": ChangeProtectedDatabaseSubscriptionDetails, "ChangeProtectionPolicyCompartmentDetails": ChangeProtectionPolicyCompartmentDetails, "ChangeRecoveryServiceSubnetCompartmentDetails": ChangeRecoveryServiceSubnetCompartmentDetails, "CreateProtectedDatabaseDetails": CreateProtectedDatabaseDetails, diff --git a/src/oci/recovery/models/change_protected_database_subscription_details.py b/src/oci/recovery/models/change_protected_database_subscription_details.py new file mode 100644 index 0000000000..67ecda8885 --- /dev/null +++ b/src/oci/recovery/models/change_protected_database_subscription_details.py @@ -0,0 +1,103 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20210216 + + +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 ChangeProtectedDatabaseSubscriptionDetails(object): + """ + Subscription details of the new cloud service environment, such as Microsoft Azure, where the protected database will be provisioned. + """ + + def __init__(self, **kwargs): + """ + Initializes a new ChangeProtectedDatabaseSubscriptionDetails object with values from keyword arguments. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param subscription_id: + The value to assign to the subscription_id property of this ChangeProtectedDatabaseSubscriptionDetails. + :type subscription_id: str + + :param is_default: + The value to assign to the is_default property of this ChangeProtectedDatabaseSubscriptionDetails. + :type is_default: bool + + """ + self.swagger_types = { + 'subscription_id': 'str', + 'is_default': 'bool' + } + + self.attribute_map = { + 'subscription_id': 'subscriptionId', + 'is_default': 'isDefault' + } + + self._subscription_id = None + self._is_default = None + + @property + def subscription_id(self): + """ + Gets the subscription_id of this ChangeProtectedDatabaseSubscriptionDetails. + The OCID of the new cloud service subscription to which you want to link the protected database. + + + :return: The subscription_id of this ChangeProtectedDatabaseSubscriptionDetails. + :rtype: str + """ + return self._subscription_id + + @subscription_id.setter + def subscription_id(self, subscription_id): + """ + Sets the subscription_id of this ChangeProtectedDatabaseSubscriptionDetails. + The OCID of the new cloud service subscription to which you want to link the protected database. + + + :param subscription_id: The subscription_id of this ChangeProtectedDatabaseSubscriptionDetails. + :type: str + """ + self._subscription_id = subscription_id + + @property + def is_default(self): + """ + Gets the is_default of this ChangeProtectedDatabaseSubscriptionDetails. + Indicates whether it is a Universal Credit Model (UCM) subscription. + + + :return: The is_default of this ChangeProtectedDatabaseSubscriptionDetails. + :rtype: bool + """ + return self._is_default + + @is_default.setter + def is_default(self, is_default): + """ + Sets the is_default of this ChangeProtectedDatabaseSubscriptionDetails. + Indicates whether it is a Universal Credit Model (UCM) subscription. + + + :param is_default: The is_default of this ChangeProtectedDatabaseSubscriptionDetails. + :type: bool + """ + self._is_default = is_default + + 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/recovery/models/create_protected_database_details.py b/src/oci/recovery/models/create_protected_database_details.py index 772c69579e..3a1dedb106 100644 --- a/src/oci/recovery/models/create_protected_database_details.py +++ b/src/oci/recovery/models/create_protected_database_details.py @@ -97,6 +97,10 @@ def __init__(self, **kwargs): The value to assign to the is_redo_logs_shipped property of this CreateProtectedDatabaseDetails. :type is_redo_logs_shipped: bool + :param subscription_id: + The value to assign to the subscription_id property of this CreateProtectedDatabaseDetails. + :type subscription_id: str + :param freeform_tags: The value to assign to the freeform_tags property of this CreateProtectedDatabaseDetails. :type freeform_tags: dict(str, str) @@ -119,6 +123,7 @@ def __init__(self, **kwargs): 'change_rate': 'float', 'compression_ratio': 'float', 'is_redo_logs_shipped': 'bool', + 'subscription_id': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' } @@ -136,6 +141,7 @@ def __init__(self, **kwargs): 'change_rate': 'changeRate', 'compression_ratio': 'compressionRatio', 'is_redo_logs_shipped': 'isRedoLogsShipped', + 'subscription_id': 'subscriptionId', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' } @@ -152,6 +158,7 @@ def __init__(self, **kwargs): self._change_rate = None self._compression_ratio = None self._is_redo_logs_shipped = None + self._subscription_id = None self._freeform_tags = None self._defined_tags = None @@ -456,6 +463,32 @@ def is_redo_logs_shipped(self, is_redo_logs_shipped): """ self._is_redo_logs_shipped = is_redo_logs_shipped + @property + def subscription_id(self): + """ + Gets the subscription_id of this CreateProtectedDatabaseDetails. + The OCID of the cloud service subscription to which you want to link the protected database. + For example, specify the Microsoft Azure subscription ID if you want to provision the protected database in Azure. + + + :return: The subscription_id of this CreateProtectedDatabaseDetails. + :rtype: str + """ + return self._subscription_id + + @subscription_id.setter + def subscription_id(self, subscription_id): + """ + Sets the subscription_id of this CreateProtectedDatabaseDetails. + The OCID of the cloud service subscription to which you want to link the protected database. + For example, specify the Microsoft Azure subscription ID if you want to provision the protected database in Azure. + + + :param subscription_id: The subscription_id of this CreateProtectedDatabaseDetails. + :type: str + """ + self._subscription_id = subscription_id + @property def freeform_tags(self): """ diff --git a/src/oci/recovery/models/create_protection_policy_details.py b/src/oci/recovery/models/create_protection_policy_details.py index 00462fa27c..6488a70539 100644 --- a/src/oci/recovery/models/create_protection_policy_details.py +++ b/src/oci/recovery/models/create_protection_policy_details.py @@ -32,6 +32,10 @@ def __init__(self, **kwargs): The value to assign to the compartment_id property of this CreateProtectionPolicyDetails. :type compartment_id: str + :param must_enforce_cloud_locality: + The value to assign to the must_enforce_cloud_locality property of this CreateProtectionPolicyDetails. + :type must_enforce_cloud_locality: bool + :param policy_locked_date_time: The value to assign to the policy_locked_date_time property of this CreateProtectionPolicyDetails. :type policy_locked_date_time: str @@ -49,6 +53,7 @@ def __init__(self, **kwargs): 'display_name': 'str', 'backup_retention_period_in_days': 'int', 'compartment_id': 'str', + 'must_enforce_cloud_locality': 'bool', 'policy_locked_date_time': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))' @@ -58,6 +63,7 @@ def __init__(self, **kwargs): 'display_name': 'displayName', 'backup_retention_period_in_days': 'backupRetentionPeriodInDays', 'compartment_id': 'compartmentId', + 'must_enforce_cloud_locality': 'mustEnforceCloudLocality', 'policy_locked_date_time': 'policyLockedDateTime', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags' @@ -66,6 +72,7 @@ def __init__(self, **kwargs): self._display_name = None self._backup_retention_period_in_days = None self._compartment_id = None + self._must_enforce_cloud_locality = None self._policy_locked_date_time = None self._freeform_tags = None self._defined_tags = None @@ -142,6 +149,38 @@ def compartment_id(self, compartment_id): """ self._compartment_id = compartment_id + @property + def must_enforce_cloud_locality(self): + """ + Gets the must_enforce_cloud_locality of this CreateProtectionPolicyDetails. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + This parameter is applicable if your Oracle Database runs in a different cloud service environment, such as Microsoft Azure. + If you set the mustEnforceCloudLocality parameter to TRUE, then Recovery Service stores the database backups locally in the same cloud service environment where the database resides. For example, if your Oracle Database is provisioned on Microsoft Azure, then Recovery Service stores the database backups in Azure. + Note: + You cannot change the mustEnforceCloudLocality setting for a protection policy after you create it. + + + :return: The must_enforce_cloud_locality of this CreateProtectionPolicyDetails. + :rtype: bool + """ + return self._must_enforce_cloud_locality + + @must_enforce_cloud_locality.setter + def must_enforce_cloud_locality(self, must_enforce_cloud_locality): + """ + Sets the must_enforce_cloud_locality of this CreateProtectionPolicyDetails. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + This parameter is applicable if your Oracle Database runs in a different cloud service environment, such as Microsoft Azure. + If you set the mustEnforceCloudLocality parameter to TRUE, then Recovery Service stores the database backups locally in the same cloud service environment where the database resides. For example, if your Oracle Database is provisioned on Microsoft Azure, then Recovery Service stores the database backups in Azure. + Note: + You cannot change the mustEnforceCloudLocality setting for a protection policy after you create it. + + + :param must_enforce_cloud_locality: The must_enforce_cloud_locality of this CreateProtectionPolicyDetails. + :type: bool + """ + self._must_enforce_cloud_locality = must_enforce_cloud_locality + @property def policy_locked_date_time(self): """ diff --git a/src/oci/recovery/models/protected_database.py b/src/oci/recovery/models/protected_database.py index e1100e74b0..f805c48298 100644 --- a/src/oci/recovery/models/protected_database.py +++ b/src/oci/recovery/models/protected_database.py @@ -185,6 +185,10 @@ def __init__(self, **kwargs): The value to assign to the metrics property of this ProtectedDatabase. :type metrics: oci.recovery.models.Metrics + :param subscription_id: + The value to assign to the subscription_id property of this ProtectedDatabase. + :type subscription_id: str + :param freeform_tags: The value to assign to the freeform_tags property of this ProtectedDatabase. :type freeform_tags: dict(str, str) @@ -221,6 +225,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'str', 'health_details': 'str', 'metrics': 'Metrics', + 'subscription_id': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))', 'system_tags': 'dict(str, dict(str, object))' @@ -249,6 +254,7 @@ def __init__(self, **kwargs): 'lifecycle_details': 'lifecycleDetails', 'health_details': 'healthDetails', 'metrics': 'metrics', + 'subscription_id': 'subscriptionId', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags', 'system_tags': 'systemTags' @@ -276,6 +282,7 @@ def __init__(self, **kwargs): self._lifecycle_details = None self._health_details = None self._metrics = None + self._subscription_id = None self._freeform_tags = None self._defined_tags = None self._system_tags = None @@ -856,6 +863,30 @@ def metrics(self, metrics): """ self._metrics = metrics + @property + def subscription_id(self): + """ + Gets the subscription_id of this ProtectedDatabase. + The OCID of the cloud service subscription to which the protected database is linked. + + + :return: The subscription_id of this ProtectedDatabase. + :rtype: str + """ + return self._subscription_id + + @subscription_id.setter + def subscription_id(self, subscription_id): + """ + Sets the subscription_id of this ProtectedDatabase. + The OCID of the cloud service subscription to which the protected database is linked. + + + :param subscription_id: The subscription_id of this ProtectedDatabase. + :type: str + """ + self._subscription_id = subscription_id + @property def freeform_tags(self): """ diff --git a/src/oci/recovery/models/protected_database_summary.py b/src/oci/recovery/models/protected_database_summary.py index 037ad5e725..f512a02ee2 100644 --- a/src/oci/recovery/models/protected_database_summary.py +++ b/src/oci/recovery/models/protected_database_summary.py @@ -175,6 +175,10 @@ def __init__(self, **kwargs): The value to assign to the metrics property of this ProtectedDatabaseSummary. :type metrics: oci.recovery.models.MetricsSummary + :param subscription_id: + The value to assign to the subscription_id property of this ProtectedDatabaseSummary. + :type subscription_id: str + :param freeform_tags: The value to assign to the freeform_tags property of this ProtectedDatabaseSummary. :type freeform_tags: dict(str, str) @@ -207,6 +211,7 @@ def __init__(self, **kwargs): 'health_details': 'str', 'is_read_only_resource': 'bool', 'metrics': 'MetricsSummary', + 'subscription_id': 'str', 'freeform_tags': 'dict(str, str)', 'defined_tags': 'dict(str, dict(str, object))', 'system_tags': 'dict(str, dict(str, object))' @@ -231,6 +236,7 @@ def __init__(self, **kwargs): 'health_details': 'healthDetails', 'is_read_only_resource': 'isReadOnlyResource', 'metrics': 'metrics', + 'subscription_id': 'subscriptionId', 'freeform_tags': 'freeformTags', 'defined_tags': 'definedTags', 'system_tags': 'systemTags' @@ -254,6 +260,7 @@ def __init__(self, **kwargs): self._health_details = None self._is_read_only_resource = None self._metrics = None + self._subscription_id = None self._freeform_tags = None self._defined_tags = None self._system_tags = None @@ -714,6 +721,30 @@ def metrics(self, metrics): """ self._metrics = metrics + @property + def subscription_id(self): + """ + Gets the subscription_id of this ProtectedDatabaseSummary. + The OCID of the cloud service subscription to which the protected database is linked. + + + :return: The subscription_id of this ProtectedDatabaseSummary. + :rtype: str + """ + return self._subscription_id + + @subscription_id.setter + def subscription_id(self, subscription_id): + """ + Sets the subscription_id of this ProtectedDatabaseSummary. + The OCID of the cloud service subscription to which the protected database is linked. + + + :param subscription_id: The subscription_id of this ProtectedDatabaseSummary. + :type: str + """ + self._subscription_id = subscription_id + @property def freeform_tags(self): """ diff --git a/src/oci/recovery/models/protection_policy.py b/src/oci/recovery/models/protection_policy.py index bf7859c5f8..ae8836a2e1 100644 --- a/src/oci/recovery/models/protection_policy.py +++ b/src/oci/recovery/models/protection_policy.py @@ -73,6 +73,10 @@ def __init__(self, **kwargs): The value to assign to the policy_locked_date_time property of this ProtectionPolicy. :type policy_locked_date_time: str + :param must_enforce_cloud_locality: + The value to assign to the must_enforce_cloud_locality property of this ProtectionPolicy. + :type must_enforce_cloud_locality: bool + :param time_created: The value to assign to the time_created property of this ProtectionPolicy. :type time_created: datetime @@ -111,6 +115,7 @@ def __init__(self, **kwargs): 'backup_retention_period_in_days': 'int', 'is_predefined_policy': 'bool', 'policy_locked_date_time': 'str', + 'must_enforce_cloud_locality': 'bool', 'time_created': 'datetime', 'time_updated': 'datetime', 'lifecycle_state': 'str', @@ -127,6 +132,7 @@ def __init__(self, **kwargs): 'backup_retention_period_in_days': 'backupRetentionPeriodInDays', 'is_predefined_policy': 'isPredefinedPolicy', 'policy_locked_date_time': 'policyLockedDateTime', + 'must_enforce_cloud_locality': 'mustEnforceCloudLocality', 'time_created': 'timeCreated', 'time_updated': 'timeUpdated', 'lifecycle_state': 'lifecycleState', @@ -142,6 +148,7 @@ def __init__(self, **kwargs): self._backup_retention_period_in_days = None self._is_predefined_policy = None self._policy_locked_date_time = None + self._must_enforce_cloud_locality = None self._time_created = None self._time_updated = None self._lifecycle_state = None @@ -294,6 +301,30 @@ def policy_locked_date_time(self, policy_locked_date_time): """ self._policy_locked_date_time = policy_locked_date_time + @property + def must_enforce_cloud_locality(self): + """ + Gets the must_enforce_cloud_locality of this ProtectionPolicy. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + + + :return: The must_enforce_cloud_locality of this ProtectionPolicy. + :rtype: bool + """ + return self._must_enforce_cloud_locality + + @must_enforce_cloud_locality.setter + def must_enforce_cloud_locality(self, must_enforce_cloud_locality): + """ + Sets the must_enforce_cloud_locality of this ProtectionPolicy. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + + + :param must_enforce_cloud_locality: The must_enforce_cloud_locality of this ProtectionPolicy. + :type: bool + """ + self._must_enforce_cloud_locality = must_enforce_cloud_locality + @property def time_created(self): """ diff --git a/src/oci/recovery/models/protection_policy_summary.py b/src/oci/recovery/models/protection_policy_summary.py index e3465c2572..0a92d7d42d 100644 --- a/src/oci/recovery/models/protection_policy_summary.py +++ b/src/oci/recovery/models/protection_policy_summary.py @@ -79,6 +79,10 @@ def __init__(self, **kwargs): The value to assign to the policy_locked_date_time property of this ProtectionPolicySummary. :type policy_locked_date_time: str + :param must_enforce_cloud_locality: + The value to assign to the must_enforce_cloud_locality property of this ProtectionPolicySummary. + :type must_enforce_cloud_locality: bool + :param time_created: The value to assign to the time_created property of this ProtectionPolicySummary. :type time_created: datetime @@ -117,6 +121,7 @@ def __init__(self, **kwargs): 'backup_retention_period_in_days': 'int', 'is_predefined_policy': 'bool', 'policy_locked_date_time': 'str', + 'must_enforce_cloud_locality': 'bool', 'time_created': 'datetime', 'time_updated': 'datetime', 'lifecycle_state': 'str', @@ -133,6 +138,7 @@ def __init__(self, **kwargs): 'backup_retention_period_in_days': 'backupRetentionPeriodInDays', 'is_predefined_policy': 'isPredefinedPolicy', 'policy_locked_date_time': 'policyLockedDateTime', + 'must_enforce_cloud_locality': 'mustEnforceCloudLocality', 'time_created': 'timeCreated', 'time_updated': 'timeUpdated', 'lifecycle_state': 'lifecycleState', @@ -148,6 +154,7 @@ def __init__(self, **kwargs): self._backup_retention_period_in_days = None self._is_predefined_policy = None self._policy_locked_date_time = None + self._must_enforce_cloud_locality = None self._time_created = None self._time_updated = None self._lifecycle_state = None @@ -300,6 +307,30 @@ def policy_locked_date_time(self, policy_locked_date_time): """ self._policy_locked_date_time = policy_locked_date_time + @property + def must_enforce_cloud_locality(self): + """ + Gets the must_enforce_cloud_locality of this ProtectionPolicySummary. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + + + :return: The must_enforce_cloud_locality of this ProtectionPolicySummary. + :rtype: bool + """ + return self._must_enforce_cloud_locality + + @must_enforce_cloud_locality.setter + def must_enforce_cloud_locality(self, must_enforce_cloud_locality): + """ + Sets the must_enforce_cloud_locality of this ProtectionPolicySummary. + Indicates whether the protection policy enforces Recovery Service to retain backups in the same cloud service environment where your Oracle Database is provisioned. + + + :param must_enforce_cloud_locality: The must_enforce_cloud_locality of this ProtectionPolicySummary. + :type: bool + """ + self._must_enforce_cloud_locality = must_enforce_cloud_locality + @property def time_created(self): """ diff --git a/src/oci/service_endpoints.py b/src/oci/service_endpoints.py index 01986aadd1..a75c9ab289 100644 --- a/src/oci/service_endpoints.py +++ b/src/oci/service_endpoints.py @@ -32,6 +32,7 @@ "redirect": "https://waas.{domain}", "resource_manager": "https://resourcemanager.{domain}", "resource_search": "https://query.{domain}", + "service": "https://announcements.{domain}", "stream": "https://streams.{domain}", "stream_admin": "https://streams.{domain}", "virtual_network": "https://iaas.{domain}", diff --git a/src/oci/version.py b/src/oci/version.py index 9dfe5f331a..aa28580c4c 100644 --- a/src/oci/version.py +++ b/src/oci/version.py @@ -2,4 +2,4 @@ # Copyright (c) 2016, 2024, 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.132.0" +__version__ = "2.133.0" diff --git a/src/oci/waf/models/__init__.py b/src/oci/waf/models/__init__.py index dd2f07e0ee..3c35cb8fed 100644 --- a/src/oci/waf/models/__init__.py +++ b/src/oci/waf/models/__init__.py @@ -22,6 +22,7 @@ from .create_web_app_firewall_details import CreateWebAppFirewallDetails from .create_web_app_firewall_load_balancer_details import CreateWebAppFirewallLoadBalancerDetails from .create_web_app_firewall_policy_details import CreateWebAppFirewallPolicyDetails +from .dynamic_http_response_body import DynamicHttpResponseBody from .http_response_body import HttpResponseBody from .network_address_list import NetworkAddressList from .network_address_list_addresses import NetworkAddressListAddresses @@ -89,6 +90,7 @@ "CreateWebAppFirewallDetails": CreateWebAppFirewallDetails, "CreateWebAppFirewallLoadBalancerDetails": CreateWebAppFirewallLoadBalancerDetails, "CreateWebAppFirewallPolicyDetails": CreateWebAppFirewallPolicyDetails, + "DynamicHttpResponseBody": DynamicHttpResponseBody, "HttpResponseBody": HttpResponseBody, "NetworkAddressList": NetworkAddressList, "NetworkAddressListAddresses": NetworkAddressListAddresses, diff --git a/src/oci/waf/models/dynamic_http_response_body.py b/src/oci/waf/models/dynamic_http_response_body.py new file mode 100644 index 0000000000..ab5e1a1376 --- /dev/null +++ b/src/oci/waf/models/dynamic_http_response_body.py @@ -0,0 +1,104 @@ +# coding: utf-8 +# Copyright (c) 2016, 2024, 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. + +# NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20210930 + +from .http_response_body import HttpResponseBody +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 DynamicHttpResponseBody(HttpResponseBody): + """ + Allows returning dynamically generated HTTP response body based on the provided template. + The template allows variable interpolation by specifying variable name between the '${' and '}' delimiters. + Escape sequences using '\\' are supported to allow usage of '\\\\' and '\\${' in the template to return '\\' and '\\${' in final response. + + The following variables are supported: + + * http.request.id - the HTTP request ID. For example: \"d5fa953f75ef417e4c8008ef9336d779\". + + Example: + { + \"type\": \"DYNAMIC\", + \"template\": \"{\ + \\\"code\\\": 403,\ + \\\"message\\\":\\\"Unauthorised\\\",\ + \\\"incidentId\\\": \\\"${http.request.id}\\\"\ + }\" + } + + Example with escape sequence: + { + \"type\": \"DYNAMIC\", + \"template\": \"\\\\${Returned as plain text}\" + } + """ + + def __init__(self, **kwargs): + """ + Initializes a new DynamicHttpResponseBody object with values from keyword arguments. The default value of the :py:attr:`~oci.waf.models.DynamicHttpResponseBody.type` attribute + of this class is ``DYNAMIC`` and it should not be changed. + The following keyword arguments are supported (corresponding to the getters/setters of this class): + + :param type: + The value to assign to the type property of this DynamicHttpResponseBody. + Allowed values for this property are: "STATIC_TEXT", "DYNAMIC" + :type type: str + + :param template: + The value to assign to the template property of this DynamicHttpResponseBody. + :type template: str + + """ + self.swagger_types = { + 'type': 'str', + 'template': 'str' + } + + self.attribute_map = { + 'type': 'type', + 'template': 'template' + } + + self._type = None + self._template = None + self._type = 'DYNAMIC' + + @property + def template(self): + """ + **[Required]** Gets the template of this DynamicHttpResponseBody. + Dynamic response body + + + :return: The template of this DynamicHttpResponseBody. + :rtype: str + """ + return self._template + + @template.setter + def template(self, template): + """ + Sets the template of this DynamicHttpResponseBody. + Dynamic response body + + + :param template: The template of this DynamicHttpResponseBody. + :type: str + """ + self._template = template + + 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/waf/models/http_response_body.py b/src/oci/waf/models/http_response_body.py index 246a2a713c..04c3d0d78b 100644 --- a/src/oci/waf/models/http_response_body.py +++ b/src/oci/waf/models/http_response_body.py @@ -19,18 +19,23 @@ class HttpResponseBody(object): #: This constant has a value of "STATIC_TEXT" TYPE_STATIC_TEXT = "STATIC_TEXT" + #: A constant which can be used with the type property of a HttpResponseBody. + #: This constant has a value of "DYNAMIC" + TYPE_DYNAMIC = "DYNAMIC" + def __init__(self, **kwargs): """ Initializes a new HttpResponseBody 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.waf.models.DynamicHttpResponseBody` * :class:`~oci.waf.models.StaticTextHttpResponseBody` The following keyword arguments are supported (corresponding to the getters/setters of this class): :param type: The value to assign to the type property of this HttpResponseBody. - Allowed values for this property are: "STATIC_TEXT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "STATIC_TEXT", "DYNAMIC", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. :type type: str @@ -53,6 +58,9 @@ def get_subtype(object_dictionary): """ type = object_dictionary['type'] + if type == 'DYNAMIC': + return 'DynamicHttpResponseBody' + if type == 'STATIC_TEXT': return 'StaticTextHttpResponseBody' else: @@ -64,7 +72,7 @@ def type(self): **[Required]** Gets the type of this HttpResponseBody. Type of HttpResponseBody. - Allowed values for this property are: "STATIC_TEXT", 'UNKNOWN_ENUM_VALUE'. + Allowed values for this property are: "STATIC_TEXT", "DYNAMIC", 'UNKNOWN_ENUM_VALUE'. Any unrecognized values returned by a service will be mapped to 'UNKNOWN_ENUM_VALUE'. @@ -83,7 +91,7 @@ def type(self, type): :param type: The type of this HttpResponseBody. :type: str """ - allowed_values = ["STATIC_TEXT"] + allowed_values = ["STATIC_TEXT", "DYNAMIC"] if not value_allowed_none_or_none_sentinel(type, allowed_values): type = 'UNKNOWN_ENUM_VALUE' self._type = type diff --git a/src/oci/waf/models/static_text_http_response_body.py b/src/oci/waf/models/static_text_http_response_body.py index f9f7a56e8e..bd1fdd3464 100644 --- a/src/oci/waf/models/static_text_http_response_body.py +++ b/src/oci/waf/models/static_text_http_response_body.py @@ -31,7 +31,7 @@ def __init__(self, **kwargs): :param type: The value to assign to the type property of this StaticTextHttpResponseBody. - Allowed values for this property are: "STATIC_TEXT" + Allowed values for this property are: "STATIC_TEXT", "DYNAMIC" :type type: str :param text: