nebius.aio.client.ClientWithOperations

class documentation

class ClientWithOperations(Client, Generic[OperationPb, OperationService]): (source)

Constructor: ClientWithOperations(channel)

View In Hierarchy

Extension of Client for services that manage long-running operations.

This helper provides an operation_service accessor that lazily creates and caches a small helper client bound to a synthetic constant channel that targets the service's operation methods.

Parameters
channel	channel used for normal RPCs; a special constant channel will be created for the operation service when needed.

Method	`__init__`	Initialize the client-with-operations.
Method	`operation_service`	Return a cached operation-service client instance.
Class Variable	`__operation_service_class__`	the client class used to manage operations.
Class Variable	`__operation_source_method__`	the method name used to identify the source of operations for this service (for example, "CreateFoo" if the service's "CreateFoo" method returns operations).
Class Variable	`__operation_type__`	the protobuf message class used to represent long-running operations.
Instance Variable	`__operation_service__`	cached instance of the operation-service client.

Inherited from Client:

Method	`request`	Construct a `nebius.aio.request.Request` for an RPC.
Class Variable	`__service_deprecation_details__`	optional deprecation message emitted as a runtime warning when the client is constructed.
Class Variable	`__service_name__`	the fully-qualified service name used in RPC routing (string).
Instance Variable	`_channel`	Undocumented

def __init__(self, channel: Channel): (source) ¶

overrides nebius.aio.client.Client.__init__

Initialize the client-with-operations.

def operation_service(self) -> OperationService: (source) ¶

Return a cached operation-service client instance.

The operation-service client is created on first access and cached on the instance. The created client is an instance of the __operation_service_class__ and is bound to a nebius.aio.constant_channel.Constant that routes calls to the service's operation endpoint.

Returns
OperationService	an instance of the operation service client

__operation_service_class__: type[OperationService] = (source) ¶

the client class used to manage operations.

__operation_source_method__: str = (source) ¶

overridden in nebius.api.nebius.applications.v1alpha1.K8sReleaseServiceClient, nebius.api.nebius.compute.v1.DiskServiceClient, nebius.api.nebius.compute.v1.FilesystemServiceClient, nebius.api.nebius.compute.v1.GpuClusterServiceClient, nebius.api.nebius.compute.v1.InstanceServiceClient, nebius.api.nebius.compute.v1alpha1.DiskServiceClient, nebius.api.nebius.compute.v1alpha1.FilesystemServiceClient, nebius.api.nebius.compute.v1alpha1.GpuClusterServiceClient, nebius.api.nebius.compute.v1alpha1.InstanceServiceClient, nebius.api.nebius.iam.v1.AccessKeyServiceClient, nebius.api.nebius.iam.v1.AccessPermitServiceClient, nebius.api.nebius.iam.v1.AuthPublicKeyServiceClient, nebius.api.nebius.iam.v1.FederatedCredentialsServiceClient, nebius.api.nebius.iam.v1.FederationCertificateServiceClient, nebius.api.nebius.iam.v1.FederationServiceClient, nebius.api.nebius.iam.v1.GroupMembershipServiceClient, nebius.api.nebius.iam.v1.GroupServiceClient, nebius.api.nebius.iam.v1.InvitationServiceClient, nebius.api.nebius.iam.v1.ProjectServiceClient, nebius.api.nebius.iam.v1.ServiceAccountServiceClient, nebius.api.nebius.iam.v1.StaticKeyServiceClient, nebius.api.nebius.iam.v1.TenantUserAccountServiceClient, nebius.api.nebius.iam.v2.AccessKeyServiceClient, nebius.api.nebius.iam.v2.ProjectServiceClient, nebius.api.nebius.iam.v2.TenantServiceClient, nebius.api.nebius.mk8s.v1.ClusterServiceClient, nebius.api.nebius.mk8s.v1.NodeGroupServiceClient, nebius.api.nebius.mk8s.v1alpha1.ClusterServiceClient, nebius.api.nebius.mk8s.v1alpha1.NodeGroupServiceClient, nebius.api.nebius.msp.mlflow.v1alpha1.ClusterServiceClient, nebius.api.nebius.msp.postgresql.v1alpha1.BackupServiceClient, nebius.api.nebius.msp.postgresql.v1alpha1.ClusterServiceClient, nebius.api.nebius.msp.serverless.v1alpha1.EndpointServiceClient, nebius.api.nebius.msp.serverless.v1alpha1.JobServiceClient, nebius.api.nebius.mysterybox.v1.SecretServiceClient, nebius.api.nebius.mysterybox.v1.SecretVersionServiceClient, nebius.api.nebius.quotas.v1.QuotaAllowanceServiceClient, nebius.api.nebius.registry.v1.ArtifactServiceClient, nebius.api.nebius.registry.v1.RegistryServiceClient, nebius.api.nebius.storage.v1.BucketServiceClient, nebius.api.nebius.storage.v1alpha1.TransferServiceClient, nebius.api.nebius.vpc.v1.AllocationServiceClient, nebius.api.nebius.vpc.v1.NetworkServiceClient, nebius.api.nebius.vpc.v1.PoolServiceClient, nebius.api.nebius.vpc.v1.RouteServiceClient, nebius.api.nebius.vpc.v1.RouteTableServiceClient, nebius.api.nebius.vpc.v1.SubnetServiceClient, nebius.api.nebius.vpc.v1.TargetGroupServiceClient, nebius.api.nebius.vpc.v1alpha1.AllocationServiceClient

the method name used to identify the source of operations for this service (for example, "CreateFoo" if the service's "CreateFoo" method returns operations).

__operation_type__: type[OperationPb] = (source) ¶

the protobuf message class used to represent long-running operations.

__operation_service__: OperationService | None = (source) ¶

cached instance of the operation-service client.