{"openapi":"3.0.0","info":{"title":"OVHcloud API specification","description":"Specification for OVHcloud API","version":"1.0","contact":{"name":"OVH","email":"api@ml.ovh.net"}},"servers":[{"url":"https://api.eu.ovhcloud.com/v2"}],"components":{"schemas":{"any":{"description":"Can be anything (text, int, bool, json, html, etc.)","example":"This is a content of any type !"},"common.CurrentTask":{"type":"object","description":"Asynchronous operation currently running","properties":{"errors":{"type":"array","description":"Errors that occurred on the task","nullable":true,"items":{"$ref":"#/components/schemas/common.TaskError"},"readOnly":true},"id":{"type":"string","description":"Identifier of the current task","format":"uuid","readOnly":true},"link":{"type":"string","description":"Link to the task details","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.CurrentTaskStatusEnum"}],"description":"Current global status of the current task","nullable":true,"readOnly":true},"type":{"type":"string","description":"Type of the current task","readOnly":true}}},"common.CurrentTaskStatusEnum":{"type":"string","description":"Current status of a task. A task in ERROR cannot be retried without your inputs. PENDING tasks will be executed as soon as possible. A RUNNING task is currently executing your original request. SCHEDULED is used for tasks that will be executed in the future.","enum":["ERROR","PENDING","RUNNING","SCHEDULED","WAITING_USER_INPUT"]},"common.Event":{"type":"object","description":"Represents an event for an async envelope","properties":{"createdAt":{"type":"string","description":"Creation date of the event","format":"date-time","readOnly":true},"kind":{"type":"string","description":"Nature of the event","readOnly":true},"link":{"type":"string","description":"Link to the event related resource","nullable":true,"readOnly":true},"message":{"type":"string","description":"Description of what happened on the event","readOnly":true},"type":{"allOf":[{"$ref":"#/components/schemas/common.EventTypeEnum"}],"description":"Type of the event","readOnly":true}}},"common.EventTypeEnum":{"type":"string","description":"Nature of an event","enum":["TARGET_SPEC_UPDATE","TASK_ERROR","TASK_START","TASK_SUCCESS"]},"common.ResourceStatusEnum":{"type":"string","description":"Current status of a resource","enum":["CREATING","CREATION_PLANNED","DELETING","ERROR","OUT_OF_SYNC","READY","SUSPENDED","UNKNOWN","UPDATING"]},"common.Task":{"type":"object","description":"Asynchronous operation","properties":{"createdAt":{"type":"string","description":"Creation date of the task","format":"date-time","readOnly":true},"errors":{"type":"array","description":"Errors that occurred on the task","nullable":true,"items":{"$ref":"#/components/schemas/common.TaskError"},"readOnly":true},"finishedAt":{"type":"string","description":"Ending date of the task","nullable":true,"format":"date-time","readOnly":true},"id":{"type":"string","description":"Unique identifier of the task","format":"uuid","readOnly":true},"link":{"type":"string","description":"Link to the related resource","readOnly":true},"message":{"type":"string","description":"Description of the task","readOnly":true},"progress":{"type":"array","description":"Progress steps of the asynchronous operation","items":{"$ref":"#/components/schemas/common.TaskProgress"},"readOnly":true},"startedAt":{"type":"string","description":"Starting date of the task","nullable":true,"format":"date-time","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.TaskStatusEnum"}],"description":"Current global status of the task","readOnly":true},"type":{"type":"string","description":"Type of the task","readOnly":true},"updatedAt":{"type":"string","description":"Last update of the task","format":"date-time","readOnly":true}}},"common.TaskError":{"type":"object","description":"Errors that occurred on the task","properties":{"message":{"type":"string","description":"Error description","readOnly":true}}},"common.TaskProgress":{"type":"object","description":"Detailed information about an asynchronous operation progress steps","properties":{"name":{"type":"string","description":"Progress step name","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/common.TaskStatusEnum"}],"description":"Current status of the progress step","readOnly":true}}},"common.TaskStatusEnum":{"type":"string","description":"Current status of a task","enum":["DONE","ERROR","PENDING","RUNNING","SCHEDULED","WAITING_USER_INPUT"]},"duration":{"type":"string","description":"Duration (e.g., P1Y2M3DT4H6M9S)","example":"P1Y2M3DT4H6M9S"},"email":{"type":"string","description":"Email address (e.g., api@ml.ovh.net)","format":"email","example":"api@ml.ovh.net"},"internationalPhoneNumber":{"type":"string","description":"International phone number","format":"phone-number"},"ip":{"type":"string","description":"IP address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipBlock":{"type":"string","description":"IP (v4 or v6) CIDR notation (e.g., 192.0.2.0/24)","format":"ip-block","example":"192.0.2.0/24"},"ipInterface":{"type":"string","description":"IP address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipv4":{"type":"string","description":"IPv4 address (e.g., 192.0.2.0)","format":"ipv4","example":"192.0.2.0"},"ipv4Block":{"type":"string","description":"IPv4 CIDR notation (e.g., 192.0.2.0/24)","format":"ipv4-block","example":"192.0.2.0/24"},"ipv6":{"type":"string","description":"IPv6 address (e.g., 2001:41d0:1:1994::1)","format":"ipv6","example":"2001:41d0:1:1994::1"},"ipv6Block":{"type":"string","description":"IPv6 CIDR notation (e.g., 2001:41d0::/128)","format":"ipv6-block","example":"2001:41d0::/128"},"macAddress":{"type":"string","description":"MAC address (e.g., 00:00:5e:00:53:01)","format":"mac-address","example":"00:00:5e:00:53:01"},"phoneNumber":{"type":"string","description":"Phone number","format":"phone-number"},"publicCloud.lakehouse.Credential":{"type":"object","description":"A credential of a lakehouse user: an OAuth2 client, with an S3 key when asked for, that acts with the rights of the roles of the user, until the credential expires or is revoked. Its secrets are returned once, at creation.","properties":{"checksum":{"type":"string","description":"Hash of the target specification of the credential","readOnly":true},"createdAt":{"type":"string","description":"Date the credential was created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialCurrentState"}],"description":"Current state of the credential, computed by the service","readOnly":true},"currentTasks":{"type":"array","description":"Tasks in progress on the credential. Always an empty array: a credential is created and revoked synchronously.","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the credential","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Readiness status of the credential. Always READY: a credential is created and revoked synchronously. Whether it still works is `currentState.status`.","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialTargetSpec"}],"description":"Specification of the credential, as requested at creation and completed with the defaults","readOnly":true},"updatedAt":{"type":"string","description":"Date of the last change to the credential","format":"date-time","readOnly":true}}},"publicCloud.lakehouse.CredentialCreation":{"type":"object","description":"Creation of a credential","properties":{"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialTargetSpec"}],"description":"Specification of the credential to create. Send an empty object to take every default."}},"required":["targetSpec"]},"publicCloud.lakehouse.CredentialCurrentState":{"type":"object","description":"Current state of a credential, computed by the service","properties":{"accessKey":{"type":"string","description":"S3 access key of the credential. Null when the credential was created without S3 access, and for the credential named `initial` whose S3 key was issued before credentials existed.","nullable":true,"readOnly":true},"clientId":{"type":"string","description":"OAuth2 client identifier of the credential","readOnly":true},"createdAt":{"type":"string","description":"Date the credential was created","format":"date-time","readOnly":true},"expiresAt":{"type":"string","description":"Date the credential stops working","format":"date-time","readOnly":true},"name":{"type":"string","description":"Name of the credential","readOnly":true},"revokedAt":{"type":"string","description":"Date the credential was revoked. Null unless the status is REVOKED.","nullable":true,"format":"date-time","readOnly":true},"revokedBy":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialRevokedByEnum"}],"description":"Who revoked the credential. Null unless the status is REVOKED.","nullable":true,"readOnly":true},"s3Access":{"type":"boolean","description":"Whether the credential holds an S3 access key. True for the credential named `initial`, whose S3 key predates the credentials and is not returned in accessKey.","readOnly":true},"status":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialStatusEnum"}],"description":"Whether the credential works, computed from its expiry and revocation dates","readOnly":true}}},"publicCloud.lakehouse.CredentialRevokedByEnum":{"type":"string","description":"Who revoked a lakehouse credential. `CUSTOMER`: you, through the API. `OPERATOR`: OVHcloud support. `SYSTEM`: the service itself.","enum":["CUSTOMER","OPERATOR","SYSTEM"]},"publicCloud.lakehouse.CredentialStatusEnum":{"type":"string","description":"Status of a lakehouse credential. `ACTIVE`: it works. `EXPIRED`: its expiry date has passed. `REVOKED`: it was revoked before its expiry.","enum":["ACTIVE","EXPIRED","REVOKED"]},"publicCloud.lakehouse.CredentialTargetSpec":{"type":"object","description":"Specification of a credential, as you requested it. Every field is optional on creation and always filled in responses.","properties":{"expiresAt":{"type":"string","description":"Date the credential stops working. At least 10 minutes ahead and at most the lifetime limit of the lakehouse: 90 days unless OVHcloud set another limit. Immutable after creation. Defaults to that limit.","nullable":true,"format":"date-time"},"name":{"type":"string","description":"Name of the credential, 1 to 64 characters, not unique. Immutable after creation. Defaults to `credential-<yyyymmdd>` of the creation day.","nullable":true},"s3Access":{"type":"boolean","description":"Whether the credential gets an S3 access key, for a tool that reads or writes the bucket directly. Apache Iceberg REST, SQL and the data console need none. Immutable after creation. Defaults to false.","nullable":true}}},"publicCloud.lakehouse.Credentials":{"type":"object","description":"Connection details and secrets of a lakehouse credential, returned once, by the creation of the credential or by the deprecated credentials reset. You cannot read the secrets again: store them safely, or create a new credential.","properties":{"catalogUri":{"type":"string","description":"Base URI of the Apache Iceberg REST catalog of the region, for your Iceberg client","readOnly":true},"catalogs":{"type":"array","description":"Catalogs reached at the time of issue by the roles of the user, including those of its groups, sorted by `warehouse`. Empty when they reach none.","items":{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialsCatalog"},"readOnly":true},"clientId":{"type":"string","description":"OAuth2 client identifier of the credential","readOnly":true},"clientSecret":{"type":"string","description":"OAuth2 client secret of the credential. Returned only once, in the response that issues it.","format":"password","readOnly":true},"realm":{"type":"string","description":"Realm of the lakehouse, to send in the `Polaris-Realm` header of your Apache Iceberg client","readOnly":true},"s3":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialsS3"}],"description":"S3 key of the credential for direct access to the storage of the lakehouse. Null when the credential was created without S3 access, or when the region does not issue S3 keys.","nullable":true,"readOnly":true},"tokenUri":{"type":"string","description":"URI of the OAuth2 token service, where your client exchanges the client identifier and secret for a token","readOnly":true}}},"publicCloud.lakehouse.CredentialsCatalog":{"type":"object","description":"A catalog the credentials reach","properties":{"catalogId":{"type":"string","description":"Identifier of the catalog","format":"uuid","readOnly":true},"sqlCatalog":{"type":"string","description":"Name the SQL endpoint serves the catalog under: a table is `<sqlCatalog>.<schema>.<table>`","readOnly":true},"warehouse":{"type":"string","description":"Warehouse name of the catalog, for your Apache Iceberg client","readOnly":true}}},"publicCloud.lakehouse.CredentialsS3":{"type":"object","description":"S3 key of a lakehouse credential. It reads or changes only the objects of the catalogs and schemas the roles of the user reach, but lists the object names, sizes and dates of the whole bucket of the lakehouse as soon as the user may read any data.","properties":{"accessKey":{"type":"string","description":"S3 access key","readOnly":true},"bucket":{"type":"string","description":"Bucket holding the data of the lakehouse. Null when the bucket is not created yet.","nullable":true,"readOnly":true},"endpoint":{"type":"string","description":"S3 endpoint of the region","readOnly":true},"region":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.RegionEnum"}],"description":"S3 region name to configure in your S3 client","readOnly":true},"secretKey":{"type":"string","description":"S3 secret key. Returned only once, in the response that issues it.","format":"password","readOnly":true}}},"publicCloud.lakehouse.IssuedCredential":{"type":"object","description":"A credential just created, with its secrets. The secrets are returned once, in this response only: store them safely.","properties":{"checksum":{"type":"string","description":"Hash of the target specification of the credential","readOnly":true},"createdAt":{"type":"string","description":"Date the credential was created","format":"date-time","readOnly":true},"credentials":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.Credentials"}],"description":"Connection details and secrets of the credential, returned once","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialCurrentState"}],"description":"Current state of the credential, computed by the service","readOnly":true},"currentTasks":{"type":"array","description":"Tasks in progress on the credential. Always an empty array: a credential is created and revoked synchronously.","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the credential","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Readiness status of the credential. Always READY: a credential is created and revoked synchronously. Whether it still works is `currentState.status`.","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialTargetSpec"}],"description":"Specification of the credential, as requested at creation and completed with the defaults","readOnly":true},"updatedAt":{"type":"string","description":"Date of the last change to the credential","format":"date-time","readOnly":true}}},"publicCloud.lakehouse.RegionEnum":{"type":"string","description":"Region name of a lakehouse. The lakehouse region reference lists the regions open to new lakehouses.","enum":["eu-west-par","eu-west-poc"]},"publicCloud.lakehouse.StatusReason":{"type":"object","description":"Why a resource is in ERROR","properties":{"code":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.StatusReasonCodeEnum"}],"description":"Stable code of the reason, for programs","readOnly":true},"message":{"type":"string","description":"Explanation of the reason, for people. It may change. Do not parse it.","readOnly":true}}},"publicCloud.lakehouse.StatusReasonCodeEnum":{"type":"string","description":"Stable code of the reason why a resource is in ERROR. CATALOG_NOT_EMPTY, LAKEHOUSE_NOT_EMPTY and SCHEMA_NOT_EMPTY: a deletion was refused because data remains. Delete again with force. DEDICATED_COMPUTE_POOL_EXISTS, DEDICATED_UNAVAILABLE, INVALID_SHAPE and QUOTA_EXCEEDED: the region refused the Compute Pool shape. `RECONCILE_FAILED`: a DEDICATED engine stopped serving. `CANCELED`: OVHcloud support canceled the change. `TIMED_OUT`: the change did not complete in time. `REGION_UNAVAILABLE`: the region could not take the change. `OPERATION_FAILED`: any other failure.","enum":["CANCELED","CATALOG_NOT_EMPTY","DEDICATED_COMPUTE_POOL_EXISTS","DEDICATED_UNAVAILABLE","INVALID_SHAPE","LAKEHOUSE_NOT_EMPTY","OPERATION_FAILED","QUOTA_EXCEEDED","RECONCILE_FAILED","REGION_UNAVAILABLE","SCHEMA_NOT_EMPTY","TIMED_OUT"]},"publicCloud.lakehouse.User":{"type":"object","description":"An identity of a lakehouse: a person or a service account that signs in to the lakehouse with its own credentials","properties":{"checksum":{"type":"string","description":"Hash of the target specification of the user. Send it back on update to make sure nobody changed the user in between.","readOnly":true},"createdAt":{"type":"string","description":"Date the user was created","format":"date-time","readOnly":true},"currentState":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserCurrentState"}],"description":"Current state of the user, computed by the service","readOnly":true},"currentTasks":{"type":"array","description":"Tasks in progress on the user, and its last failed task while the user is in ERROR. Always an array. Empty when there is none.","items":{"$ref":"#/components/schemas/common.CurrentTask"},"readOnly":true},"id":{"type":"string","description":"Unique identifier of the user","format":"uuid","readOnly":true},"resourceStatus":{"allOf":[{"$ref":"#/components/schemas/common.ResourceStatusEnum"}],"description":"Readiness status of the user. A change is accepted only in READY or ERROR, except after a refused deletion (ERROR with a `*_NOT_EMPTY` status reason code), where only a new deletion is accepted. A deletion is also accepted in CREATING and UPDATING and replaces the change in progress.","readOnly":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserTargetSpec"}],"description":"Last requested specification of the user","readOnly":true},"updatedAt":{"type":"string","description":"Date of the last change to the user","format":"date-time","readOnly":true}}},"publicCloud.lakehouse.UserCreation":{"type":"object","description":"Creation of a user","properties":{"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserTargetSpec"}],"description":"Specification of the user to create"}},"required":["targetSpec"]},"publicCloud.lakehouse.UserCredentialsSummary":{"type":"object","description":"Summary of the credentials of a user","properties":{"activeCount":{"type":"integer","description":"Number of ACTIVE credentials of the user","readOnly":true},"earliestExpiresAt":{"type":"string","description":"Earliest expiry date among the ACTIVE credentials of the user. Null when the user has no ACTIVE credential.","nullable":true,"format":"date-time","readOnly":true}}},"publicCloud.lakehouse.UserCurrentState":{"type":"object","description":"Current state of a user, computed by the service","properties":{"clientId":{"type":"string","description":"OAuth2 client identifier of the user. Null until the user is first READY.","nullable":true,"readOnly":true},"credentials":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserCredentialsSummary"}],"description":"Summary of the credentials of the user","readOnly":true},"credentialsResetAt":{"type":"string","description":"Date of the last credentials reset. Null until the first reset.","nullable":true,"format":"date-time","readOnly":true},"description":{"type":"string","description":"Description of the user. Null when it has none.","nullable":true,"readOnly":true},"name":{"type":"string","description":"Name of the user","readOnly":true},"statusReason":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.StatusReason"}],"description":"Why the user is in ERROR. Null in any other status.","nullable":true,"readOnly":true},"type":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserTypeEnum"}],"description":"Whether the identity is a person or a service account","readOnly":true}}},"publicCloud.lakehouse.UserTargetSpec":{"type":"object","description":"Specification of a user, as you requested it","properties":{"description":{"type":"string","description":"Description of the user. At most 255 characters.","nullable":true},"name":{"type":"string","description":"Name of the user, unique in the lakehouse. Same rules as the lakehouse name. Immutable after creation."},"type":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserTypeEnum"}],"description":"Whether the identity is a person or a service account. Immutable after creation."}},"required":["name","type"]},"publicCloud.lakehouse.UserTypeEnum":{"type":"string","description":"Kind of lakehouse identity","enum":["SERVICE_ACCOUNT","USER"]},"publicCloud.lakehouse.UserUpdate":{"type":"object","description":"Update of a user","properties":{"checksum":{"type":"string","description":"Checksum of the user as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the user changed since. When omitted or empty, no check is made.","nullable":true},"targetSpec":{"allOf":[{"$ref":"#/components/schemas/publicCloud.lakehouse.UserUpdateTargetSpec"}],"description":"New specification of the user. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused."}},"required":["targetSpec"]},"publicCloud.lakehouse.UserUpdateTargetSpec":{"type":"object","description":"Specification of a user that you can change after creation","properties":{"description":{"type":"string","description":"Description of the user. At most 255 characters.","nullable":true}}},"time":{"type":"string","description":"Time (e.g., 15:04:05)","format":"time","example":"15:04:05"}},"securitySchemes":{"oAuth2AuthCode":{"type":"oauth2","description":"Oauth2","x-client-id":"1bb9c7df371741c0","x-client-secret":"a5b4de870aca620d10fbf63cd18d205b","flows":{"authorizationCode":{"authorizationUrl":"https://auth.eu.ovhcloud.com/oauth2/authorize","tokenUrl":"https://auth.eu.ovhcloud.com/oauth2/token","scopes":{"account/all":"Manage your account","all":"Manage your whole account and all your services","services/all":"Manage your services lifecycle and billing"}}}}}},"paths":{"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user":{"get":{"operationId":"getAllLakehouseUsers","summary":"List the users of your lakehouse","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/publicCloud.lakehouse.User"}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@10"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/get","required":true}],"x-response-identifier":"id","x-expanded-response":"PublicCloudLakehouseUser"},"post":{"operationId":"createLakehouseUser","summary":"Create a user in your lakehouse","description":"Creates the user asynchronously. The response is the user in CREATING, with the creation task in `currentTasks`: follow it on the task routes of the user, or read the user until its `resourceStatus` is READY or ERROR.\n\nThe creation is refused with a 409 while the lakehouse is being deleted. Once the user is READY, create a credential to get its client secret, and an S3™* access key when you set `s3Access`.\n\n<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.UserCreation"},"examples":{"Create a user":{"value":{"targetSpec":{"description":"Nightly ETL pipeline","name":"etl_pipeline","type":"SERVICE_ACCOUNT"}},"summary":"Create a user."}}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.User"},"examples":{"User being created":{"value":{"checksum":"116feb530c1d2d6fa59abde9a46bbf42","createdAt":"2026-10-01T09:03:00Z","currentState":{"clientId":null,"credentials":{"activeCount":0,"earliestExpiresAt":null},"credentialsResetAt":null,"description":"Nightly ETL pipeline","name":"etl_pipeline","statusReason":null,"type":"SERVICE_ACCOUNT"},"currentTasks":[{"errors":[],"id":"3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","link":"/v2/publicCloud/project/5f1c2b3a4d5e6f708192a3b4c5d6e7f8/managedAnalytics/lakehouse/8b0f6d2e-3c4a-4e1b-9f7d-2a6c5e8b1d30/user/a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97/task/3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","status":"PENDING","type":"LAKEHOUSE_USER_CREATE"}],"id":"a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97","resourceStatus":"CREATING","targetSpec":{"description":"Nightly ETL pipeline","name":"etl_pipeline","type":"SERVICE_ACCOUNT"},"updatedAt":"2026-10-01T09:03:00Z"},"summary":"The user in CREATING, with its creation task."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidName":{"value":{"class":"Client::BadRequest::InvalidName","message":"Invalid name: use 3 to 63 lowercase letters, digits or underscores, starting with a letter"}},"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::NameAlreadyInUse":{"value":{"class":"Client::Conflict::NameAlreadyInUse","message":"This name is already in use"}},"Client::Conflict::QuotaExceeded":{"value":{"class":"Client::Conflict::QuotaExceeded","message":"This lakehouse has reached its quota"}},"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@30"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: publicCloud.lakehouse.UserCreation\nresult = client.post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user\",\n\ttargetSpec = None, # Specification of the user to create (type: publicCloud.lakehouse.UserTargetSpec)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: publicCloud.lakehouse.UserCreation\n$result = $ovh->post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user\", array(\n\ttargetSpec => null, // Specification of the user to create (type: publicCloud.lakehouse.UserTargetSpec)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/create","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}":{"delete":{"operationId":"deleteLakehouseUser","summary":"Delete a user of your lakehouse","description":"Deletes the user asynchronously. The response is the user in DELETING, with the deletion task in `currentTasks`. Once the deletion completes, the user and every route under it, its tasks included, answer 404. Deleting a user also deletes its role assignments and its group memberships. The deletion is refused with a 409 when it would remove the last Lakehouse Admin assignment of the lakehouse: assign the Lakehouse Admin role to another identity first.\n\nA deletion is accepted in READY and ERROR, and also in CREATING and UPDATING, where it replaces the change in progress. A new deletion while one is running is refused with a 409.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.User"}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::LastLakehouseAdmin":{"value":{"class":"Client::Conflict::LastLakehouseAdmin","message":"The last Lakehouse Admin of a lakehouse cannot be removed: assign the Lakehouse Admin role to another identity first"}},"Client::Conflict::ResourceAlreadyBeingDeleted":{"value":{"class":"Client::Conflict::ResourceAlreadyBeingDeleted","message":"Resource is already being deleted"}},"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@40"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.delete(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->delete(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/delete","required":true}]},"get":{"operationId":"getLakehouseUser","summary":"Get a user of your lakehouse","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.User"},"examples":{"User":{"value":{"checksum":"116feb530c1d2d6fa59abde9a46bbf42","createdAt":"2026-10-01T09:03:00Z","currentState":{"clientId":"lkh-etl_pipeline-a7c3e1f9","credentials":{"activeCount":2,"earliestExpiresAt":"2026-10-24T09:10:00Z"},"credentialsResetAt":"2026-10-01T09:10:00Z","description":"Nightly ETL pipeline","name":"etl_pipeline","statusReason":null,"type":"SERVICE_ACCOUNT"},"currentTasks":[],"id":"a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97","resourceStatus":"READY","targetSpec":{"description":"Nightly ETL pipeline","name":"etl_pipeline","type":"SERVICE_ACCOUNT"},"updatedAt":"2026-10-01T09:03:40Z"},"summary":"A READY user."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@20"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/get","required":true}],"x-response-identifier":"id"},"put":{"operationId":"editLakehouseUser","summary":"Update a user of your lakehouse","description":"Replaces the user's target specification as a whole. The body carries the complete desired state of every field `publicCloud.lakehouse.UserUpdateTargetSpec` exposes — `description` — so read the user first and restate every value you want to keep: a field left out of `targetSpec` is cleared, not carried over from the stored specification.\n\nThe create-only fields `name` and `type` cannot be changed once the user exists. They are deliberately absent from the update model, and sending one is rejected with a 400.\n\nOn a READY user the change is applied at once: the response is 200 with the user READY. On a user in ERROR the change is applied asynchronously, even when the specification is unchanged, to bring the user out of ERROR: the response is 202 with the user UPDATING and the new task in `currentTasks`. The update is refused with a 409 while the user is CREATING, UPDATING or DELETING, and after a refused deletion, from which only a new deletion is accepted.\n\nThe optional `checksum` guards against a lost update: when supplied it must match the user's current checksum or the request is rejected with a 409 checksum mismatch. Omitting it skips the check and forces the write (last-write-wins).","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.UserUpdate"},"examples":{"Update a user":{"value":{"checksum":"116feb530c1d2d6fa59abde9a46bbf42","targetSpec":{"description":"Nightly and hourly ETL pipelines"}},"summary":"Change the description of the user. The body is the complete target specification that you can change."}}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.User"},"examples":{"User updated":{"value":{"checksum":"0be7b44bedcc6d2009bbeee5e6648beb","createdAt":"2026-10-01T09:03:00Z","currentState":{"clientId":"lkh-etl_pipeline-a7c3e1f9","credentials":{"activeCount":2,"earliestExpiresAt":"2026-10-24T09:10:00Z"},"credentialsResetAt":"2026-10-01T09:10:00Z","description":"Nightly and hourly ETL pipelines","name":"etl_pipeline","statusReason":null,"type":"SERVICE_ACCOUNT"},"currentTasks":[],"id":"a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97","resourceStatus":"READY","targetSpec":{"description":"Nightly and hourly ETL pipelines","name":"etl_pipeline","type":"SERVICE_ACCOUNT"},"updatedAt":"2026-10-01T10:00:00Z"},"summary":"The user READY, with the change applied at once."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::ChecksumMismatch":{"value":{"class":"Client::Conflict::ChecksumMismatch","message":"Checksum mismatch — a concurrent update was detected. Refresh the resource and retry"}},"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@50"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: publicCloud.lakehouse.UserUpdate\nresult = client.put(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\",\n\tchecksum = None, # Checksum of the user as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the user changed since. When omitted or empty, no check is made. (type: string, nullable)\n\ttargetSpec = None, # New specification of the user. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused. (type: publicCloud.lakehouse.UserUpdateTargetSpec)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: publicCloud.lakehouse.UserUpdate\n$result = $ovh->put(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}\", array(\n\tchecksum => null, // Checksum of the user as you last read it. When set, the update is refused with a 409 checksum-mismatch conflict if the user changed since. When omitted or empty, no check is made. (type: string, nullable)\n\ttargetSpec => null, // New specification of the user. It replaces the whole current specification: an optional field you omit is reset to its default. Send only the fields of this model: a field that can only be set at creation is refused. (type: publicCloud.lakehouse.UserUpdateTargetSpec)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/edit","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential":{"get":{"operationId":"getAllLakehouseUserCredentials","summary":"List the credentials of a user of your lakehouse","description":"Returns the credentials of the user in every status, without their secrets. A REVOKED or EXPIRED credential stays listed for 30 days after its revocation or expiry, then is purged.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/publicCloud.lakehouse.Credential"}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credential/get","required":true}],"x-response-identifier":"id","x-expanded-response":"PublicCloudLakehouseCredential"},"post":{"operationId":"createLakehouseUserCredential","summary":"Create a credential for a user of your lakehouse and get its secrets","description":"Creates a credential and returns it with its secrets once, in this response: the client secret and the S3 secret key cannot be read again, so store them safely. The credential works for Apache Iceberg REST, SQL and S3, with the rights of the roles of the user, including those of its groups, until it expires or is revoked.\n\nA credential expires after the lifetime limit of the lakehouse by default, and at most: 90 days unless OVHcloud set another limit for the lakehouse. An `expiresAt` beyond the limit is refused with a 400 whose details give the limit, and one less than 10 minutes ahead too. The name defaults to `credential-<yyyymmdd>` of the creation day and need not be unique.\n\nThe credential gets an S3 access key only when `targetSpec.s3Access` is true. Without one, `credentials.s3` is null. A user holds at most 3 ACTIVE credentials: one more is refused with a 409. The user must be READY: the creation is refused with a 409 otherwise. The creation is synchronous: it changes neither the target specification, nor the checksum, nor the status of the user, and records no task.\n\n<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.CredentialCreation"},"examples":{"Create a credential":{"value":{"targetSpec":{"expiresAt":"2027-01-17T09:00:00Z","name":"airflow-staging","s3Access":true}},"summary":"Create a named credential with an explicit expiry."},"Create a credential with the defaults":{"value":{"targetSpec":{}},"summary":"Create a credential named after the creation day, expiring in 90 days."}}}}},"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.IssuedCredential"},"examples":{"New credential":{"value":{"checksum":"6a2e8c4f0b7d3a9e5c1f8b2d6a4e0c7f","createdAt":"2026-10-19T09:00:00Z","credentials":{"catalogUri":"https://iceberg.eu-west-par.lakehouse.ovhcloud.example/api/catalog","catalogs":[{"catalogId":"c41a7e92-6b3d-4f05-8a2e-91d7b3c6e540","sqlCatalog":"t5f1c2b3a_lkh-8b0f6d2e_sales_main","warehouse":"sales_main"}],"clientId":"lkh-etl_pipeline-2f7d4b9a","clientSecret":"example-client-secret-returned-once","realm":"lkh-8b0f6d2e","s3":{"accessKey":"8b0d2f4a6c8e1a3c5e7b9d1f3a5c7e9d","bucket":"lkh-8b0f6d2e","endpoint":"https://s3.eu-west-par.lakehouse.ovhcloud.example","region":"eu-west-par","secretKey":"example-s3-secret-key-returned-once"},"tokenUri":"https://iceberg.eu-west-par.lakehouse.ovhcloud.example/api/catalog/v1/oauth/tokens"},"currentState":{"accessKey":"8b0d2f4a6c8e1a3c5e7b9d1f3a5c7e9d","clientId":"lkh-etl_pipeline-2f7d4b9a","createdAt":"2026-10-19T09:00:00Z","expiresAt":"2027-01-17T09:00:00Z","name":"airflow-staging","revokedAt":null,"revokedBy":null,"s3Access":true,"status":"ACTIVE"},"currentTasks":[],"id":"2f7d4b9a-6e3c-4a85-9d10-c5b8e2f7a463","resourceStatus":"READY","targetSpec":{"expiresAt":"2027-01-17T09:00:00Z","name":"airflow-staging","s3Access":true},"updatedAt":"2026-10-19T09:00:00Z"},"summary":"The credential with its secrets, returned once, for a service account whose roles reach one catalog."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::CredentialTtlTooLong":{"value":{"class":"Client::BadRequest::CredentialTtlTooLong","message":"The expiry of a credential is beyond the lifetime limit of the lakehouse: the limit is in the details of this error"}},"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::CredentialQuotaExceeded":{"value":{"class":"Client::Conflict::CredentialQuotaExceeded","message":"This user already has 3 active credentials: revoke one before creating another"}},"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}},"500":{"description":"Error 500 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Server::InternalServerError::RegionUnavailable":{"value":{"class":"Server::InternalServerError::RegionUnavailable","message":"The lakehouse service of this region is temporarily unavailable. Retry later"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\n# Request body type: publicCloud.lakehouse.CredentialCreation\nresult = client.post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential\",\n\ttargetSpec = None, # Specification of the credential to create. Send an empty object to take every default. (type: publicCloud.lakehouse.CredentialTargetSpec)\n)\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n// Request body type: publicCloud.lakehouse.CredentialCreation\n$result = $ovh->post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential\", array(\n\ttargetSpec => null, // Specification of the credential to create. Send an empty object to take every default. (type: publicCloud.lakehouse.CredentialTargetSpec)\n));\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credential/create","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}":{"delete":{"operationId":"deleteLakehouseUserCredential","summary":"Delete a revoked or expired credential of a user of your lakehouse","description":"Removes the record of a REVOKED or EXPIRED credential at once, before the purge that removes it 30 days after its revocation or expiry. The response is empty. The deletion is refused with a 409 while the credential is ACTIVE: revoke it first.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"credentialId","description":"Credential ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation"}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.delete(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->delete(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credential/delete","required":true}]},"get":{"operationId":"getLakehouseUserCredential","summary":"Get a credential of a user of your lakehouse","description":"Returns the credential without its secrets, which are returned only once, at creation.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"credentialId","description":"Credential ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.Credential"},"examples":{"Credential":{"value":{"checksum":"4c1e9b7a2f6d8e3c5b0a7d9f1e2c4b6a","createdAt":"2026-10-02T08:00:00Z","currentState":{"accessKey":"7a1c3e5b9d2f4a6c8e0b1d3f5a7c9e2b","clientId":"lkh-etl_pipeline-d4e8b2a6","createdAt":"2026-10-02T08:00:00Z","expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","revokedAt":null,"revokedBy":null,"s3Access":true,"status":"ACTIVE"},"currentTasks":[],"id":"d4e8b2a6-7c1f-4a93-b5e0-2f6c9d1a8e37","resourceStatus":"READY","targetSpec":{"expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","s3Access":true},"updatedAt":"2026-10-02T08:00:00Z"},"summary":"An ACTIVE credential."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::CredentialDoesNotExist":{"value":{"class":"Client::NotFound::CredentialDoesNotExist","message":"Credential not found"}},"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credential/get","required":true}],"x-response-identifier":"id"}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}/revoke":{"post":{"operationId":"revokeLakehouseUserCredential","summary":"Revoke a credential of a user of your lakehouse","description":"Revokes the credential at once: the response is the credential REVOKED. Access through Apache Iceberg REST and SQL stops at once, including the tokens and sessions already open. The S3 key of the credential, if it has one, is deleted: OVHcloud Object Storage may keep accepting it for up to 30 minutes. To refuse S3 access within about 3 minutes, revoke every credential of the user. The other credentials of the user keep working. A revocation cannot be undone.\n\nThe credential must be ACTIVE: the revocation is refused with a 409 otherwise. It records no task.\n\n<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"credentialId","description":"Credential ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.Credential"},"examples":{"Credential revoked":{"value":{"checksum":"4c1e9b7a2f6d8e3c5b0a7d9f1e2c4b6a","createdAt":"2026-10-02T08:00:00Z","currentState":{"accessKey":"7a1c3e5b9d2f4a6c8e0b1d3f5a7c9e2b","clientId":"lkh-etl_pipeline-d4e8b2a6","createdAt":"2026-10-02T08:00:00Z","expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","revokedAt":"2026-10-19T10:00:00Z","revokedBy":"CUSTOMER","s3Access":true,"status":"REVOKED"},"currentTasks":[],"id":"d4e8b2a6-7c1f-4a93-b5e0-2f6c9d1a8e37","resourceStatus":"READY","targetSpec":{"expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","s3Access":true},"updatedAt":"2026-10-19T10:00:00Z"},"summary":"The credential REVOKED by you."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::CredentialDoesNotExist":{"value":{"class":"Client::NotFound::CredentialDoesNotExist","message":"Credential not found"}},"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}},"500":{"description":"Error 500 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Server::InternalServerError::RegionUnavailable":{"value":{"class":"Server::InternalServerError::RegionUnavailable","message":"The lakehouse service of this region is temporarily unavailable. Retry later"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}/revoke\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credential/{credentialId}/revoke\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credential/revoke","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/reset":{"post":{"operationId":"resetLakehouseUserCredentials","summary":"Deprecated: reset the credentials of a user of your lakehouse and get a new one","description":"Deprecated, to be removed at the next breaking version of the API: create a credential and revoke credentials instead.\n\nRevokes every ACTIVE credential of the user, then creates one credential named `reset` that expires 90 days later, and returns it once, in this response: the client secret and the S3 secret key cannot be read again, so store them safely. The revoked credentials stop working through Apache Iceberg REST and SQL at once, including the tokens and sessions already open. Their S3 keys are deleted and may keep working for up to 30 minutes. To stop S3 access within about 3 minutes, revoke the credentials of the user instead, then create a credential.\n\nThe user must be READY: the reset is refused with a 409 otherwise. The reset is synchronous: it changes neither the target specification, nor the checksum, nor the status of the user, and records no task.\n\n<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/publicCloud.lakehouse.Credentials"},"examples":{"New credentials":{"value":{"catalogUri":"https://iceberg.eu-west-par.lakehouse.ovhcloud.example/api/catalog","catalogs":[{"catalogId":"c41a7e92-6b3d-4f05-8a2e-91d7b3c6e540","sqlCatalog":"t5f1c2b3a_lkh-8b0f6d2e_sales_main","warehouse":"sales_main"}],"clientId":"lkh-etl_pipeline-a7c3e1f9","clientSecret":"example-client-secret-returned-once","realm":"lkh-8b0f6d2e","s3":{"accessKey":"3f9b2c7e1a4d4e8f9c0b5a6d7e8f1a2b","bucket":"lkh-8b0f6d2e","endpoint":"https://s3.eu-west-par.lakehouse.ovhcloud.example","region":"eu-west-par","secretKey":"example-s3-secret-key-returned-once"},"tokenUri":"https://iceberg.eu-west-par.lakehouse.ovhcloud.example/api/catalog/v1/oauth/tokens"},"summary":"The credentials of a service account whose roles reach one catalog."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}},"500":{"description":"Error 500 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Server::InternalServerError::RegionUnavailable":{"value":{"class":"Server::InternalServerError::RegionUnavailable","message":"The lakehouse service of this region is temporarily unavailable. Retry later"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/reset\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/reset\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credentials/reset","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/revoke":{"post":{"operationId":"revokeLakehouseUserCredentials","summary":"Revoke every active credential of a user of your lakehouse","description":"Revokes every ACTIVE credential of the user at once: the response lists the credentials revoked, empty when the user had none. Access through Apache Iceberg REST and SQL stops at once, including the tokens and sessions already open. The S3 key is refused within about 3 minutes. A revocation cannot be undone.\n\nThe user keeps its roles and its group memberships, and may get new credentials at once. The revocation changes neither the target specification, nor the checksum, nor the status of the user, and records no task.\n\n<sup>*</sup> S3 is a trademark filed by Amazon Technologies,Inc. OVHcloud's service is not sponsored by, endorsed by, or otherwise affiliated with Amazon Technologies,Inc.","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/publicCloud.lakehouse.Credential"}},"examples":{"Credentials revoked":{"value":[{"checksum":"4c1e9b7a2f6d8e3c5b0a7d9f1e2c4b6a","createdAt":"2026-10-02T08:00:00Z","currentState":{"accessKey":"7a1c3e5b9d2f4a6c8e0b1d3f5a7c9e2b","clientId":"lkh-etl_pipeline-d4e8b2a6","createdAt":"2026-10-02T08:00:00Z","expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","revokedAt":"2026-10-19T10:00:00Z","revokedBy":"CUSTOMER","s3Access":true,"status":"REVOKED"},"currentTasks":[],"id":"d4e8b2a6-7c1f-4a93-b5e0-2f6c9d1a8e37","resourceStatus":"READY","targetSpec":{"expiresAt":"2026-12-31T08:00:00Z","name":"airflow-prod","s3Access":true},"updatedAt":"2026-10-19T10:00:00Z"},{"checksum":"9d3b6f1a4c8e2b7d0f5a3c9e6b1d4f8a","createdAt":"2026-10-01T09:10:00Z","currentState":{"accessKey":"2e4a6c8b0d1f3a5c7e9b2d4f6a8c0e1b","clientId":"lkh-etl_pipeline-5b9f1e3c","createdAt":"2026-10-01T09:10:00Z","expiresAt":"2026-10-24T09:10:00Z","name":"credential-20261001","revokedAt":"2026-10-19T10:00:00Z","revokedBy":"CUSTOMER","s3Access":true,"status":"REVOKED"},"currentTasks":[],"id":"5b9f1e3c-2a7d-4c68-8e41-b7d3f0a6c925","resourceStatus":"READY","targetSpec":{"expiresAt":"2026-10-24T09:10:00Z","name":"credential-20261001","s3Access":true},"updatedAt":"2026-10-19T10:00:00Z"}],"summary":"The two ACTIVE credentials of the user, REVOKED by you."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}},"409":{"description":"Error 409 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::Conflict::ResourceInInvalidState":{"value":{"class":"Client::Conflict::ResourceInInvalidState","message":"Resource cannot be modified in its current state"}}}}}},"500":{"description":"Error 500 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Server::InternalServerError::RegionUnavailable":{"value":{"class":"Server::InternalServerError::RegionUnavailable","message":"The lakehouse service of this region is temporarily unavailable. Retry later"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@60"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/revoke\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->post(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/credentials/revoke\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/credentials/revoke","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/event":{"get":{"operationId":"getLakehouseUserEvents","summary":"List the events of a user of your lakehouse","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"query","name":"taskId","description":"Return only the events of this task","schema":{"type":"string","format":"uuid"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/common.Event"}},"examples":{"Creation history":{"value":[{"createdAt":"2026-10-01T09:03:40Z","kind":"LAKEHOUSE_USER_CREATE","link":"/v2/publicCloud/project/5f1c2b3a4d5e6f708192a3b4c5d6e7f8/managedAnalytics/lakehouse/8b0f6d2e-3c4a-4e1b-9f7d-2a6c5e8b1d30/user/a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97/task/3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","message":"Task completed","type":"TASK_SUCCESS"},{"createdAt":"2026-10-01T09:03:05Z","kind":"LAKEHOUSE_USER_CREATE","link":"/v2/publicCloud/project/5f1c2b3a4d5e6f708192a3b4c5d6e7f8/managedAnalytics/lakehouse/8b0f6d2e-3c4a-4e1b-9f7d-2a6c5e8b1d30/user/a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97/task/3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","message":"Task started","type":"TASK_START"},{"createdAt":"2026-10-01T09:03:00Z","kind":"LAKEHOUSE_USER_CREATE","link":null,"message":"Target specification updated","type":"TARGET_SPEC_UPDATE"}],"summary":"The events of a creation that completed."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@70"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/event\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/event\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/event/get","required":true}]}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task":{"get":{"operationId":"getAllLakehouseUserTasks","summary":"List the tasks of a user of your lakehouse","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"header","name":"X-Pagination-Cursor","description":"Pagination cursor","schema":{"type":"string"}},{"in":"header","name":"X-Pagination-Size","description":"Pagination size","schema":{"type":"integer"}},{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/common.Task"}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@80"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/task/get","required":true}],"x-response-identifier":"id","x-expanded-response":"CommonTask"}},"/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task/{taskId}":{"get":{"operationId":"getLakehouseUserTask","summary":"Get a task of a user of your lakehouse","security":[{"oAuth2AuthCode":[]}],"parameters":[{"in":"path","name":"lakehouseId","description":"Lakehouse ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"projectId","description":"Project ID","required":true,"schema":{"type":"string"}},{"in":"path","name":"taskId","description":"Task ID","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"path","name":"userId","description":"User ID","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/common.Task"},"examples":{"Completed task":{"value":{"createdAt":"2026-10-01T09:03:00Z","errors":[],"finishedAt":"2026-10-01T09:03:40Z","id":"3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","link":"/v2/publicCloud/project/5f1c2b3a4d5e6f708192a3b4c5d6e7f8/managedAnalytics/lakehouse/8b0f6d2e-3c4a-4e1b-9f7d-2a6c5e8b1d30/user/a7c3e1f9-2b48-4d6a-9e05-6f1b8d3c2a97/task/3f7a2d9e-8c14-4e6b-a5d0-7b2e9f1c4a68","message":"Change applied","progress":[{"name":"Provision the resource","status":"DONE"}],"startedAt":"2026-10-01T09:03:05Z","status":"DONE","type":"LAKEHOUSE_USER_CREATE","updatedAt":"2026-10-01T09:03:40Z"},"summary":"A creation task that completed."}}}}},"400":{"description":"Error 400 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::BadRequest::InvalidParameter":{"value":{"class":"Client::BadRequest::InvalidParameter","message":"Invalid parameter in the request"}}}}}},"404":{"description":"Error 404 response","content":{"application/json":{"schema":{"type":"object","description":"Common error model","properties":{"class":{"type":"string","description":"Class of the error"},"message":{"type":"string","description":"Error message"}}},"examples":{"Client::NotFound::LakehouseDoesNotExist":{"value":{"class":"Client::NotFound::LakehouseDoesNotExist","message":"Lakehouse not found"}},"Client::NotFound::TaskDoesNotExist":{"value":{"class":"Client::NotFound::TaskDoesNotExist","message":"Task not found"}},"Client::NotFound::UserDoesNotExist":{"value":{"class":"Client::NotFound::UserDoesNotExist","message":"User not found"}}}}}}},"tags":["Managed Analytics","Lakehouse"],"x-developer-hub-navigation":[["Public Cloud","Analytics","Lakehouse","Users@@@90"]],"x-badges":[{"color":"blue","label":"Alpha version"}],"x-code-samples":[{"lang":"python","label":"Python","source":"'''\nFirst, install the latest release of Python wrapper: $ pip install ovh\n'''\nimport json\nimport ovh\n\n# Instantiate an OVH Client.\n# You can generate new credentials with full access to your account on\n# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\nclient = ovh.Client(\n\tendpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n\tapplication_key='xxxxxxxxxx',    # Application Key\n\tapplication_secret='xxxxxxxxxx', # Application Secret\n\tconsumer_key='xxxxxxxxxx',       # Consumer Key\n)\n\nresult = client.get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task/{taskId}\")\n\n# Pretty print\nprint(json.dumps(result, indent=4))"},{"lang":"php","label":"PHP","source":"<?php\n/**\n * First, download the latest release of PHP wrapper on github\n * And include this script into the folder with extracted files\n */\nrequire __DIR__ . '/vendor/autoload.php';\nuse \\Ovh\\Api;\n\n/**\n * Instantiate an OVH Client.\n * You can generate new credentials with full access to your account on\n * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)\n */\n$ovh = new Api('xxxxxxxxxx',  // Application Key\n               'xxxxxxxxxx',  // Application Secret\n               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)\n               'xxxxxxxxxx'); // Consumer Key\n\n$result = $ovh->get(\"/v2/publicCloud/project/{projectId}/managedAnalytics/lakehouse/{lakehouseId}/user/{userId}/task/{taskId}\");\n\nprint_r($result);\n?>"}],"x-iam-actions":[{"name":"publicCloudProject:apiovh:analytics/lakehouse/user/task/get","required":true}],"x-response-identifier":"id"}}},"tags":[{"name":"Managed Analytics","x-tag-expanded":false,"description":"Missing description"},{"name":"Lakehouse","x-tag-expanded":false,"description":"Missing description"}]}
