databricks-sdk 0.66.0__py3-none-any.whl → 0.68.0__py3-none-any.whl

databricks/sdk/service/cleanrooms.py

@@ -10,13 +10,13 @@ from datetime import timedelta
 from enum import Enum
 from typing import Any, Callable, Dict, Iterator, List, Optional
 
-from ._internal import Wait, _enum, _from_dict, _repeated_dict
+from databricks.sdk.service import catalog, jobs, settings, sharing
+from databricks.sdk.service._internal import (Wait, _enum, _from_dict,
+                                              _repeated_dict)
 
 _LOG = logging.getLogger("databricks.sdk")
 
 
-from databricks.sdk.service import catalog, jobs, settings, sharing
-
 # all definitions in this file are in alphabetical order
 
 

databricks/sdk/service/compute.py

@@ -10,8 +10,10 @@ from datetime import timedelta
 from enum import Enum
 from typing import Any, Callable, Dict, Iterator, List, Optional
 
+from databricks.sdk.service._internal import (Wait, _enum, _from_dict,
+                                              _repeated_dict, _repeated_enum)
+
 from ..errors import OperationFailed
-from ._internal import Wait, _enum, _from_dict, _repeated_dict, _repeated_enum
 
 _LOG = logging.getLogger("databricks.sdk")
 
@@ -3135,12 +3137,9 @@ class Environment:
     """Required. Environment version used by the environment. Each version comes with a specific Python
     version and a set of Python packages. The version is a string, consisting of an integer."""
 
-    jar_dependencies: Optional[List[str]] = None
-    """Use `java_dependencies` instead."""
-
     java_dependencies: Optional[List[str]] = None
-    """List of jar dependencies, should be string representing volume paths. For example:
-    `/Volumes/path/to/test.jar`."""
+    """List of java dependencies. Each dependency is a string representing a java library path. For
+    example: `/Volumes/path/to/test.jar`."""
 
     def as_dict(self) -> dict:
         """Serializes the Environment into a dictionary suitable for use as a JSON request body."""
@@ -3151,8 +3150,6 @@ class Environment:
             body["dependencies"] = [v for v in self.dependencies]
         if self.environment_version is not None:
             body["environment_version"] = self.environment_version
-        if self.jar_dependencies:
-            body["jar_dependencies"] = [v for v in self.jar_dependencies]
         if self.java_dependencies:
             body["java_dependencies"] = [v for v in self.java_dependencies]
         return body
@@ -3166,8 +3163,6 @@ class Environment:
             body["dependencies"] = self.dependencies
         if self.environment_version is not None:
             body["environment_version"] = self.environment_version
-        if self.jar_dependencies:
-            body["jar_dependencies"] = self.jar_dependencies
         if self.java_dependencies:
             body["java_dependencies"] = self.java_dependencies
         return body
@@ -3179,7 +3174,6 @@ class Environment:
             client=d.get("client", None),
             dependencies=d.get("dependencies", None),
             environment_version=d.get("environment_version", None),
-            jar_dependencies=d.get("jar_dependencies", None),
             java_dependencies=d.get("java_dependencies", None),
         )
 
@@ -6621,9 +6615,16 @@ class Results:
     data: Optional[Any] = None
 
     file_name: Optional[str] = None
-    """The image filename"""
+    """The image data in one of the following formats:
+    
+    1. A Data URL with base64-encoded image data: `data:image/{type};base64,{base64-data}`. Example:
+    `data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...`
+    
+    2. A FileStore file path for large images: `/plots/{filename}.png`. Example:
+    `/plots/b6a7ad70-fb2c-4353-8aed-3f1e015174a4.png`"""
 
     file_names: Optional[List[str]] = None
+    """List of image data for multiple images. Each element follows the same format as file_name."""
 
     is_json_schema: Optional[bool] = None
     """true if a JSON schema is returned instead of a string representation of the Hive type."""
@@ -7067,6 +7068,7 @@ class TerminationReasonCode(Enum):
     BOOTSTRAP_TIMEOUT_DUE_TO_MISCONFIG = "BOOTSTRAP_TIMEOUT_DUE_TO_MISCONFIG"
     BUDGET_POLICY_LIMIT_ENFORCEMENT_ACTIVATED = "BUDGET_POLICY_LIMIT_ENFORCEMENT_ACTIVATED"
     BUDGET_POLICY_RESOLUTION_FAILURE = "BUDGET_POLICY_RESOLUTION_FAILURE"
+    CLOUD_ACCOUNT_POD_QUOTA_EXCEEDED = "CLOUD_ACCOUNT_POD_QUOTA_EXCEEDED"
     CLOUD_ACCOUNT_SETUP_FAILURE = "CLOUD_ACCOUNT_SETUP_FAILURE"
     CLOUD_OPERATION_CANCELLED = "CLOUD_OPERATION_CANCELLED"
     CLOUD_PROVIDER_DISK_SETUP_FAILURE = "CLOUD_PROVIDER_DISK_SETUP_FAILURE"
@@ -7144,6 +7146,7 @@ class TerminationReasonCode(Enum):
     IN_PENALTY_BOX = "IN_PENALTY_BOX"
     IP_EXHAUSTION_FAILURE = "IP_EXHAUSTION_FAILURE"
     JOB_FINISHED = "JOB_FINISHED"
+    K8S_ACTIVE_POD_QUOTA_EXCEEDED = "K8S_ACTIVE_POD_QUOTA_EXCEEDED"
     K8S_AUTOSCALING_FAILURE = "K8S_AUTOSCALING_FAILURE"
     K8S_DBR_CLUSTER_LAUNCH_TIMEOUT = "K8S_DBR_CLUSTER_LAUNCH_TIMEOUT"
     LAZY_ALLOCATION_TIMEOUT = "LAZY_ALLOCATION_TIMEOUT"
@@ -8493,11 +8496,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/delete", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_terminated,
-            response=DeleteClusterResponse.from_dict(op_response),
-            cluster_id=cluster_id,
-        )
+        return Wait(self.wait_get_cluster_terminated, cluster_id=cluster_id)
 
     def delete_and_wait(self, cluster_id: str, timeout=timedelta(minutes=20)) -> ClusterDetails:
         return self.delete(cluster_id=cluster_id).result(timeout=timeout)
@@ -8759,9 +8758,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/edit", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_running, response=EditClusterResponse.from_dict(op_response), cluster_id=cluster_id
-        )
+        return Wait(self.wait_get_cluster_running, cluster_id=cluster_id)
 
     def edit_and_wait(
         self,
@@ -9123,9 +9120,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/resize", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_running, response=ResizeClusterResponse.from_dict(op_response), cluster_id=cluster_id
-        )
+        return Wait(self.wait_get_cluster_running, cluster_id=cluster_id)
 
     def resize_and_wait(
         self,
@@ -9160,9 +9155,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/restart", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_running, response=RestartClusterResponse.from_dict(op_response), cluster_id=cluster_id
-        )
+        return Wait(self.wait_get_cluster_running, cluster_id=cluster_id)
 
     def restart_and_wait(
         self, cluster_id: str, *, restart_user: Optional[str] = None, timeout=timedelta(minutes=20)
@@ -9229,9 +9222,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/start", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_running, response=StartClusterResponse.from_dict(op_response), cluster_id=cluster_id
-        )
+        return Wait(self.wait_get_cluster_running, cluster_id=cluster_id)
 
     def start_and_wait(self, cluster_id: str, timeout=timedelta(minutes=20)) -> ClusterDetails:
         return self.start(cluster_id=cluster_id).result(timeout=timeout)
@@ -9302,9 +9293,7 @@ class ClustersAPI:
         }
 
         op_response = self._api.do("POST", "/api/2.1/clusters/update", body=body, headers=headers)
-        return Wait(
-            self.wait_get_cluster_running, response=UpdateClusterResponse.from_dict(op_response), cluster_id=cluster_id
-        )
+        return Wait(self.wait_get_cluster_running, cluster_id=cluster_id)
 
     def update_and_wait(
         self,
@@ -9485,7 +9474,6 @@ class CommandExecutionAPI:
         op_response = self._api.do("POST", "/api/1.2/commands/cancel", body=body, headers=headers)
         return Wait(
             self.wait_command_status_command_execution_cancelled,
-            response=CancelResponse.from_dict(op_response),
             cluster_id=cluster_id,
             command_id=command_id,
             context_id=context_id,

databricks/sdk/service/dashboards.py

@@ -10,14 +10,15 @@ from datetime import timedelta
 from enum import Enum
 from typing import Any, Callable, Dict, Iterator, List, Optional
 
+from databricks.sdk.service import sql
+from databricks.sdk.service._internal import (Wait, _enum, _from_dict,
+                                              _repeated_dict)
+
 from ..errors import OperationFailed
-from ._internal import Wait, _enum, _from_dict, _repeated_dict
 
 _LOG = logging.getLogger("databricks.sdk")
 
 
-from databricks.sdk.service import sql
-
 # all definitions in this file are in alphabetical order
 
 
@@ -714,6 +715,8 @@ class GenieQueryAttachment:
     last_updated_timestamp: Optional[int] = None
     """Time when the user updated the query last"""
 
+    parameters: Optional[List[QueryAttachmentParameter]] = None
+
     query: Optional[str] = None
     """AI generated SQL query"""
 
@@ -736,6 +739,8 @@ class GenieQueryAttachment:
             body["id"] = self.id
         if self.last_updated_timestamp is not None:
             body["last_updated_timestamp"] = self.last_updated_timestamp
+        if self.parameters:
+            body["parameters"] = [v.as_dict() for v in self.parameters]
         if self.query is not None:
             body["query"] = self.query
         if self.query_result_metadata:
@@ -755,6 +760,8 @@ class GenieQueryAttachment:
             body["id"] = self.id
         if self.last_updated_timestamp is not None:
             body["last_updated_timestamp"] = self.last_updated_timestamp
+        if self.parameters:
+            body["parameters"] = self.parameters
         if self.query is not None:
             body["query"] = self.query
         if self.query_result_metadata:
@@ -772,6 +779,7 @@ class GenieQueryAttachment:
             description=d.get("description", None),
             id=d.get("id", None),
             last_updated_timestamp=d.get("last_updated_timestamp", None),
+            parameters=_repeated_dict(d, "parameters", QueryAttachmentParameter),
             query=d.get("query", None),
             query_result_metadata=_from_dict(d, "query_result_metadata", GenieResultMetadata),
             statement_id=d.get("statement_id", None),
@@ -1135,6 +1143,7 @@ class MessageErrorType(Enum):
     DESCRIBE_QUERY_INVALID_SQL_ERROR = "DESCRIBE_QUERY_INVALID_SQL_ERROR"
     DESCRIBE_QUERY_TIMEOUT = "DESCRIBE_QUERY_TIMEOUT"
     DESCRIBE_QUERY_UNEXPECTED_FAILURE = "DESCRIBE_QUERY_UNEXPECTED_FAILURE"
+    EXCEEDED_MAX_TOKEN_LENGTH_EXCEPTION = "EXCEEDED_MAX_TOKEN_LENGTH_EXCEPTION"
     FUNCTIONS_NOT_AVAILABLE_EXCEPTION = "FUNCTIONS_NOT_AVAILABLE_EXCEPTION"
     FUNCTION_ARGUMENTS_INVALID_EXCEPTION = "FUNCTION_ARGUMENTS_INVALID_EXCEPTION"
     FUNCTION_ARGUMENTS_INVALID_JSON_EXCEPTION = "FUNCTION_ARGUMENTS_INVALID_JSON_EXCEPTION"
@@ -1145,6 +1154,9 @@ class MessageErrorType(Enum):
     GENERIC_CHAT_COMPLETION_SERVICE_EXCEPTION = "GENERIC_CHAT_COMPLETION_SERVICE_EXCEPTION"
     GENERIC_SQL_EXEC_API_CALL_EXCEPTION = "GENERIC_SQL_EXEC_API_CALL_EXCEPTION"
     ILLEGAL_PARAMETER_DEFINITION_EXCEPTION = "ILLEGAL_PARAMETER_DEFINITION_EXCEPTION"
+    INTERNAL_CATALOG_ASSET_CREATION_FAILED_EXCEPTION = "INTERNAL_CATALOG_ASSET_CREATION_FAILED_EXCEPTION"
+    INTERNAL_CATALOG_ASSET_CREATION_ONGOING_EXCEPTION = "INTERNAL_CATALOG_ASSET_CREATION_ONGOING_EXCEPTION"
+    INTERNAL_CATALOG_ASSET_CREATION_UNSUPPORTED_EXCEPTION = "INTERNAL_CATALOG_ASSET_CREATION_UNSUPPORTED_EXCEPTION"
     INTERNAL_CATALOG_MISSING_UC_PATH_EXCEPTION = "INTERNAL_CATALOG_MISSING_UC_PATH_EXCEPTION"
     INTERNAL_CATALOG_PATH_OVERLAP_EXCEPTION = "INTERNAL_CATALOG_PATH_OVERLAP_EXCEPTION"
     INVALID_CERTIFIED_ANSWER_FUNCTION_EXCEPTION = "INVALID_CERTIFIED_ANSWER_FUNCTION_EXCEPTION"
@@ -1260,6 +1272,42 @@ class PublishedDashboard:
         )
 
 
+@dataclass
+class QueryAttachmentParameter:
+    keyword: Optional[str] = None
+
+    sql_type: Optional[str] = None
+
+    value: Optional[str] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the QueryAttachmentParameter into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.keyword is not None:
+            body["keyword"] = self.keyword
+        if self.sql_type is not None:
+            body["sql_type"] = self.sql_type
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the QueryAttachmentParameter into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.keyword is not None:
+            body["keyword"] = self.keyword
+        if self.sql_type is not None:
+            body["sql_type"] = self.sql_type
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> QueryAttachmentParameter:
+        """Deserializes the QueryAttachmentParameter from a dictionary."""
+        return cls(keyword=d.get("keyword", None), sql_type=d.get("sql_type", None), value=d.get("value", None))
+
+
 @dataclass
 class Result:
     is_truncated: Optional[bool] = None

databricks/sdk/service/database.py

@@ -10,7 +10,8 @@ from datetime import timedelta
 from enum import Enum
 from typing import Any, Callable, Dict, Iterator, List, Optional
 
-from ._internal import Wait, _enum, _from_dict, _repeated_dict
+from databricks.sdk.service._internal import (Wait, _enum, _from_dict,
+                                              _repeated_dict)
 
 _LOG = logging.getLogger("databricks.sdk")
 
@@ -18,6 +19,38 @@ _LOG = logging.getLogger("databricks.sdk")
 # all definitions in this file are in alphabetical order
 
 
+@dataclass
+class CustomTag:
+    key: Optional[str] = None
+    """The key of the custom tag."""
+
+    value: Optional[str] = None
+    """The value of the custom tag."""
+
+    def as_dict(self) -> dict:
+        """Serializes the CustomTag into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.key is not None:
+            body["key"] = self.key
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the CustomTag into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.key is not None:
+            body["key"] = self.key
+        if self.value is not None:
+            body["value"] = self.value
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> CustomTag:
+        """Deserializes the CustomTag from a dictionary."""
+        return cls(key=d.get("key", None), value=d.get("value", None))
+
+
 @dataclass
 class DatabaseCatalog:
     name: str
@@ -125,9 +158,16 @@ class DatabaseInstance:
     creator: Optional[str] = None
     """The email of the creator of the instance."""
 
+    custom_tags: Optional[List[CustomTag]] = None
+    """Custom tags associated with the instance. This field is only included on create and update
+    responses."""
+
     effective_capacity: Optional[str] = None
     """Deprecated. The sku of the instance; this field will always match the value of capacity."""
 
+    effective_custom_tags: Optional[List[CustomTag]] = None
+    """The recorded custom tags associated with the instance."""
+
     effective_enable_pg_native_login: Optional[bool] = None
     """Whether the instance has PG native password login enabled."""
 
@@ -145,6 +185,9 @@ class DatabaseInstance:
     effective_stopped: Optional[bool] = None
     """Whether the instance is stopped."""
 
+    effective_usage_policy_id: Optional[str] = None
+    """The policy that is applied to the instance."""
+
     enable_pg_native_login: Optional[bool] = None
     """Whether to enable PG native password login on the instance. Defaults to false."""
 
@@ -184,6 +227,9 @@ class DatabaseInstance:
     uid: Optional[str] = None
     """An immutable UUID identifier for the instance."""
 
+    usage_policy_id: Optional[str] = None
+    """The desired usage policy to associate with the instance."""
+
     def as_dict(self) -> dict:
         """Serializes the DatabaseInstance into a dictionary suitable for use as a JSON request body."""
         body = {}
@@ -195,8 +241,12 @@ class DatabaseInstance:
             body["creation_time"] = self.creation_time
         if self.creator is not None:
             body["creator"] = self.creator
+        if self.custom_tags:
+            body["custom_tags"] = [v.as_dict() for v in self.custom_tags]
         if self.effective_capacity is not None:
             body["effective_capacity"] = self.effective_capacity
+        if self.effective_custom_tags:
+            body["effective_custom_tags"] = [v.as_dict() for v in self.effective_custom_tags]
         if self.effective_enable_pg_native_login is not None:
             body["effective_enable_pg_native_login"] = self.effective_enable_pg_native_login
         if self.effective_enable_readable_secondaries is not None:
@@ -207,6 +257,8 @@ class DatabaseInstance:
             body["effective_retention_window_in_days"] = self.effective_retention_window_in_days
         if self.effective_stopped is not None:
             body["effective_stopped"] = self.effective_stopped
+        if self.effective_usage_policy_id is not None:
+            body["effective_usage_policy_id"] = self.effective_usage_policy_id
         if self.enable_pg_native_login is not None:
             body["enable_pg_native_login"] = self.enable_pg_native_login
         if self.enable_readable_secondaries is not None:
@@ -231,6 +283,8 @@ class DatabaseInstance:
             body["stopped"] = self.stopped
         if self.uid is not None:
             body["uid"] = self.uid
+        if self.usage_policy_id is not None:
+            body["usage_policy_id"] = self.usage_policy_id
         return body
 
     def as_shallow_dict(self) -> dict:
@@ -244,8 +298,12 @@ class DatabaseInstance:
             body["creation_time"] = self.creation_time
         if self.creator is not None:
             body["creator"] = self.creator
+        if self.custom_tags:
+            body["custom_tags"] = self.custom_tags
         if self.effective_capacity is not None:
             body["effective_capacity"] = self.effective_capacity
+        if self.effective_custom_tags:
+            body["effective_custom_tags"] = self.effective_custom_tags
         if self.effective_enable_pg_native_login is not None:
             body["effective_enable_pg_native_login"] = self.effective_enable_pg_native_login
         if self.effective_enable_readable_secondaries is not None:
@@ -256,6 +314,8 @@ class DatabaseInstance:
             body["effective_retention_window_in_days"] = self.effective_retention_window_in_days
         if self.effective_stopped is not None:
             body["effective_stopped"] = self.effective_stopped
+        if self.effective_usage_policy_id is not None:
+            body["effective_usage_policy_id"] = self.effective_usage_policy_id
         if self.enable_pg_native_login is not None:
             body["enable_pg_native_login"] = self.enable_pg_native_login
         if self.enable_readable_secondaries is not None:
@@ -280,6 +340,8 @@ class DatabaseInstance:
             body["stopped"] = self.stopped
         if self.uid is not None:
             body["uid"] = self.uid
+        if self.usage_policy_id is not None:
+            body["usage_policy_id"] = self.usage_policy_id
         return body
 
     @classmethod
@@ -290,12 +352,15 @@ class DatabaseInstance:
             child_instance_refs=_repeated_dict(d, "child_instance_refs", DatabaseInstanceRef),
             creation_time=d.get("creation_time", None),
             creator=d.get("creator", None),
+            custom_tags=_repeated_dict(d, "custom_tags", CustomTag),
             effective_capacity=d.get("effective_capacity", None),
+            effective_custom_tags=_repeated_dict(d, "effective_custom_tags", CustomTag),
             effective_enable_pg_native_login=d.get("effective_enable_pg_native_login", None),
             effective_enable_readable_secondaries=d.get("effective_enable_readable_secondaries", None),
             effective_node_count=d.get("effective_node_count", None),
             effective_retention_window_in_days=d.get("effective_retention_window_in_days", None),
             effective_stopped=d.get("effective_stopped", None),
+            effective_usage_policy_id=d.get("effective_usage_policy_id", None),
             enable_pg_native_login=d.get("enable_pg_native_login", None),
             enable_readable_secondaries=d.get("enable_readable_secondaries", None),
             name=d.get("name", None),
@@ -308,6 +373,7 @@ class DatabaseInstance:
             state=_enum(d, "state", DatabaseInstanceState),
             stopped=d.get("stopped", None),
             uid=d.get("uid", None),
+            usage_policy_id=d.get("usage_policy_id", None),
         )
 
 
@@ -390,25 +456,34 @@ class DatabaseInstanceRef:
 class DatabaseInstanceRole:
     """A DatabaseInstanceRole represents a Postgres role in a database instance."""
 
+    name: str
+    """The name of the role. This is the unique identifier for the role in an instance."""
+
     attributes: Optional[DatabaseInstanceRoleAttributes] = None
-    """API-exposed Postgres role attributes"""
+    """The desired API-exposed Postgres role attribute to associate with the role. Optional."""
+
+    effective_attributes: Optional[DatabaseInstanceRoleAttributes] = None
+    """The attributes that are applied to the role."""
 
     identity_type: Optional[DatabaseInstanceRoleIdentityType] = None
     """The type of the role."""
 
+    instance_name: Optional[str] = None
+
     membership_role: Optional[DatabaseInstanceRoleMembershipRole] = None
     """An enum value for a standard role that this role is a member of."""
 
-    name: Optional[str] = None
-    """The name of the role. This is the unique identifier for the role in an instance."""
-
     def as_dict(self) -> dict:
         """Serializes the DatabaseInstanceRole into a dictionary suitable for use as a JSON request body."""
         body = {}
         if self.attributes:
             body["attributes"] = self.attributes.as_dict()
+        if self.effective_attributes:
+            body["effective_attributes"] = self.effective_attributes.as_dict()
         if self.identity_type is not None:
             body["identity_type"] = self.identity_type.value
+        if self.instance_name is not None:
+            body["instance_name"] = self.instance_name
         if self.membership_role is not None:
             body["membership_role"] = self.membership_role.value
         if self.name is not None:
@@ -420,8 +495,12 @@ class DatabaseInstanceRole:
         body = {}
         if self.attributes:
             body["attributes"] = self.attributes
+        if self.effective_attributes:
+            body["effective_attributes"] = self.effective_attributes
         if self.identity_type is not None:
             body["identity_type"] = self.identity_type
+        if self.instance_name is not None:
+            body["instance_name"] = self.instance_name
         if self.membership_role is not None:
             body["membership_role"] = self.membership_role
         if self.name is not None:
@@ -433,7 +512,9 @@ class DatabaseInstanceRole:
         """Deserializes the DatabaseInstanceRole from a dictionary."""
         return cls(
             attributes=_from_dict(d, "attributes", DatabaseInstanceRoleAttributes),
+            effective_attributes=_from_dict(d, "effective_attributes", DatabaseInstanceRoleAttributes),
             identity_type=_enum(d, "identity_type", DatabaseInstanceRoleIdentityType),
+            instance_name=d.get("instance_name", None),
             membership_role=_enum(d, "membership_role", DatabaseInstanceRoleMembershipRole),
             name=d.get("name", None),
         )
@@ -868,7 +949,7 @@ class RequestedResource:
 
 @dataclass
 class SyncedDatabaseTable:
-    """Next field marker: 14"""
+    """Next field marker: 18"""
 
     name: str
     """Full three-part (catalog, schema, table) name of the table."""
@@ -1527,22 +1608,32 @@ class DatabaseAPI:
         return self.create_database_instance(database_instance=database_instance).result(timeout=timeout)
 
     def create_database_instance_role(
-        self, instance_name: str, database_instance_role: DatabaseInstanceRole
+        self,
+        instance_name: str,
+        database_instance_role: DatabaseInstanceRole,
+        *,
+        database_instance_name: Optional[str] = None,
     ) -> DatabaseInstanceRole:
         """Create a role for a Database Instance.
 
         :param instance_name: str
         :param database_instance_role: :class:`DatabaseInstanceRole`
+        :param database_instance_name: str (optional)
 
         :returns: :class:`DatabaseInstanceRole`
         """
         body = database_instance_role.as_dict()
+        query = {}
+        if database_instance_name is not None:
+            query["database_instance_name"] = database_instance_name
         headers = {
             "Accept": "application/json",
             "Content-Type": "application/json",
         }
 
-        res = self._api.do("POST", f"/api/2.0/database/instances/{instance_name}/roles", body=body, headers=headers)
+        res = self._api.do(
+            "POST", f"/api/2.0/database/instances/{instance_name}/roles", query=query, body=body, headers=headers
+        )
         return DatabaseInstanceRole.from_dict(res)
 
     def create_database_table(self, table: DatabaseTable) -> DatabaseTable: