# Public Cloud › Container › Managed Private Registry API

> Part of the OVHcloud developer hub. Index of every page and section: https://developers.eu.ovhcloud.com/llms.txt
> The Public Cloud product's sections: https://developers.eu.ovhcloud.com/reference/public-cloud/llms.txt
> Everything in one file: https://developers.eu.ovhcloud.com/llms-full.txt

> 13 operations of the OVHcloud API. Calls carry `authorization: Bearer $OVH_TOKEN`; the EU host is shown, Canada and the United States answer on api.ca.ovhcloud.com and api.us.ovhcloud.com.

Page: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/

OpenAPI v1: https://api.eu.ovhcloud.com/v1/__schemas/developer-hub-navigation/public-cloud/container/managed-private-registry.json?format=openapi3
OpenAPI v2: https://api.eu.ovhcloud.com/v2/__schemas/developer-hub-navigation/public-cloud/container/managed-private-registry.json?format=openapi3

## Operations

- `GET /publicCloud/project/{projectId}/managedRegistry` — List Managed Private Registry services
- `POST /publicCloud/project/{projectId}/managedRegistry` — Create a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}` — Get a Managed Private Registry service
- `PUT /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}` — Update a Managed Private Registry service
- `DELETE /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}` — Delete a Managed Private Registry service
- `POST /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/adminCredentials` — Reset the administrator password of a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/plan` — List plans a Managed Private Registry service can switch to
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/version` — List Harbor versions a Managed Private Registry service can be upgraded to
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/event` — List events of a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task` — List asynchronous tasks of a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task/{taskId}` — Get an asynchronous task of a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/reference/managedRegistry/plan` — List plans available to create a Managed Private Registry service
- `GET /publicCloud/project/{projectId}/reference/managedRegistry/region` — List regions available to create a Managed Private Registry service

## List Managed Private Registry services

`GET /v2/publicCloud/project/{projectId}/managedRegistry`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getAllManagedRegistries

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Registry[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Checksum. Hash of the current `targetSpec`. Send it back in `PUT .../managedRegistry/{managedRegistryId}` to detect concurrent updates. Changes on every `targetSpec` update. |
| `createdAt` | string (date-time) | read-only | Creation date of the registry |
| `currentState` | publicCloud.managedRegistry.RegistryCurrentState | read-only | Current state. Configuration applied to the registry. Reported by the service. See RegistryCurrentState. |
| `currentState.authentication` | publicCloud.managedRegistry.Authentication | read-only | Login method applied to the registry. Reported by the service. See Authentication. |
| `currentState.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `currentState.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `currentState.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps | read-only | Authorized IPs. IP filtering applied to the registry. When `rules` is empty or null, any IP is allowed. Reported by the service. See AuthorizedIps. |
| `currentState.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `currentState.name` | string | read-only | Display name applied to the registry. Reported by the service. |
| `currentState.plan` | publicCloud.managedRegistry.PlanEnum | read-only | Plan applied to the registry. Reported by the service. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `currentState.region` | string | read-only | Region where the registry is deployed, for example `EU-WEST-PAR`. Reported by the service. |
| `currentState.url` | string | read-only | URL of the Harbor web interface and registry endpoint, for example `https://xxxxxx.eu-west-par.container-registry.ovh.net`. Null until the registry is deployed. Reported by the service. |
| `currentState.usage` | publicCloud.managedRegistry.Usage | read-only | Resources consumed by the registry. Reported by the service. See Usage. |
| `currentState.usage.artifactStorage` | publicCloud.managedRegistry.ArtifactStorage | read-only | Artifact storage consumed and its limit. Reported by the service. See ArtifactStorage. |
| `currentState.usage.measuredAt` | string (date-time) | read-only | Measured at. Time of the last usage measurement. Null until the first measurement is collected. Reported by the service. |
| `currentState.version` | string | read-only | Harbor version running on the registry, for example `2.14.2`. Reported by the service. |
| `currentTasks` | common.CurrentTask[] | read-only | Current tasks. Asynchronous tasks running on the registry. Empty or null when none is running. Follow `link` to get a task. Reported by the service. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the registry |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Resource status. Readiness of the registry. A new `targetSpec` is accepted only when it is `READY`. Reported by the service. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | read-only | Target specification. Last configuration requested for the registry. Mutable through `PUT .../managedRegistry/{managedRegistryId}`. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |
| `updatedAt` | string (date-time) | read-only | Date of the last update of the registry |

```json
[
  {
    "checksum": "string",
    "createdAt": "2024-01-01T12:00:00Z",
    "currentState": {
      "authentication": {
        "oidc": {
          "adminGroup": "string",
          "autoOnboard": true,
          "clientId": "string",
          "clientSecret": "string",
          "endpoint": "string",
          "groupFilter": "string",
          "groupsClaim": "string",
          "name": "string",
          "scope": "string",
          "userClaim": "string",
          "verifyCert": true
        },
        "type": "IAM"
      },
      "authorizedIps": {
        "rules": [
          {
            "cidr": "192.0.2.0/24",
            "description": "string",
            "scopes": [
              null
            ]
          }
        ]
      },
      "name": "string",
      "plan": "LARGE",
      "region": "string",
      "url": "string",
      "usage": {
        "artifactStorage": {
          "limit": {
            "unit": "COUNT",
            "value": 0
          },
          "used": {
            "unit": "COUNT",
            "value": 0
          }
        },
        "measuredAt": "2024-01-01T12:00:00Z"
      },
      "version": "string"
    },
    "currentTasks": [
      {
        "errors": [
          {
            "message": "string"
          }
        ],
        "id": "00000000-0000-0000-0000-000000000000",
        "link": "string",
        "status": "ERROR",
        "type": "string"
      }
    ],
    "id": "00000000-0000-0000-0000-000000000000",
    "resourceStatus": "CREATING",
    "targetSpec": {
      "authentication": {
        "oidc": {
  …
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry");

print_r($result);
?>
```

## Create a Managed Private Registry service

`POST /v2/publicCloud/project/{projectId}/managedRegistry`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#createManagedRegistry

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/create`

The registry runs the latest available Harbor version. Change it later with `targetSpec.version` on `PUT .../managedRegistry/{managedRegistryId}`.

### Asynchronous creation

The registry is returned with `resourceStatus` `CREATING` and a `REGISTRY_CREATE` task in `currentTasks`. Poll `GET .../managedRegistry/{managedRegistryId}` until `resourceStatus` is `READY`. `currentState.url` and `currentState.usage` are null until then. Once the registry is `READY`, generate the administrator password with `POST .../managedRegistry/{managedRegistryId}/adminCredentials`.

### Immutable fields

`region` cannot change after creation. Create a new registry to change it.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `projectId` | path | string | yes | Project ID |

### Request body (required)

Type: `publicCloud.managedRegistry.RegistryCreation`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | yes | Target specification. Configuration the registry is created with. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, except `region`, which is immutable. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |

```json
{
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "region": "string",
    "version": "string"
  }
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Registry | successful operation |
| 400 | object | Error 400 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Checksum. Hash of the current `targetSpec`. Send it back in `PUT .../managedRegistry/{managedRegistryId}` to detect concurrent updates. Changes on every `targetSpec` update. |
| `createdAt` | string (date-time) | read-only | Creation date of the registry |
| `currentState` | publicCloud.managedRegistry.RegistryCurrentState | read-only | Current state. Configuration applied to the registry. Reported by the service. See RegistryCurrentState. |
| `currentState.authentication` | publicCloud.managedRegistry.Authentication | read-only | Login method applied to the registry. Reported by the service. See Authentication. |
| `currentState.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `currentState.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `currentState.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps | read-only | Authorized IPs. IP filtering applied to the registry. When `rules` is empty or null, any IP is allowed. Reported by the service. See AuthorizedIps. |
| `currentState.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `currentState.name` | string | read-only | Display name applied to the registry. Reported by the service. |
| `currentState.plan` | publicCloud.managedRegistry.PlanEnum | read-only | Plan applied to the registry. Reported by the service. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `currentState.region` | string | read-only | Region where the registry is deployed, for example `EU-WEST-PAR`. Reported by the service. |
| `currentState.url` | string | read-only | URL of the Harbor web interface and registry endpoint, for example `https://xxxxxx.eu-west-par.container-registry.ovh.net`. Null until the registry is deployed. Reported by the service. |
| `currentState.usage` | publicCloud.managedRegistry.Usage | read-only | Resources consumed by the registry. Reported by the service. See Usage. |
| `currentState.usage.artifactStorage` | publicCloud.managedRegistry.ArtifactStorage | read-only | Artifact storage consumed and its limit. Reported by the service. See ArtifactStorage. |
| `currentState.usage.measuredAt` | string (date-time) | read-only | Measured at. Time of the last usage measurement. Null until the first measurement is collected. Reported by the service. |
| `currentState.version` | string | read-only | Harbor version running on the registry, for example `2.14.2`. Reported by the service. |
| `currentTasks` | common.CurrentTask[] | read-only | Current tasks. Asynchronous tasks running on the registry. Empty or null when none is running. Follow `link` to get a task. Reported by the service. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the registry |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Resource status. Readiness of the registry. A new `targetSpec` is accepted only when it is `READY`. Reported by the service. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | read-only | Target specification. Last configuration requested for the registry. Mutable through `PUT .../managedRegistry/{managedRegistryId}`. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |
| `updatedAt` | string (date-time) | read-only | Date of the last update of the registry |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "region": "string",
    "url": "string",
    "usage": {
      "artifactStorage": {
        "limit": {
          "unit": "COUNT",
          "value": 0
        },
        "used": {
          "unit": "COUNT",
          "value": 0
        }
      },
      "measuredAt": "2024-01-01T12:00:00Z"
    },
    "version": "string"
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
  …
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: publicCloud.managedRegistry.RegistryCreation
result = client.post("/v2/publicCloud/project/{projectId}/managedRegistry",
	targetSpec = None, # Target specification. Configuration the registry is created with. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, except `region`, which is immutable. See RegistryTargetSpec. (type: publicCloud.managedRegistry.RegistryTargetSpec)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: publicCloud.managedRegistry.RegistryCreation
$result = $ovh->post("/v2/publicCloud/project/{projectId}/managedRegistry", array(
	targetSpec => null, // Target specification. Configuration the registry is created with. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, except `region`, which is immutable. See RegistryTargetSpec. (type: publicCloud.managedRegistry.RegistryTargetSpec)
));

print_r($result);
?>
```

## Get a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getManagedRegistry

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Registry | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Checksum. Hash of the current `targetSpec`. Send it back in `PUT .../managedRegistry/{managedRegistryId}` to detect concurrent updates. Changes on every `targetSpec` update. |
| `createdAt` | string (date-time) | read-only | Creation date of the registry |
| `currentState` | publicCloud.managedRegistry.RegistryCurrentState | read-only | Current state. Configuration applied to the registry. Reported by the service. See RegistryCurrentState. |
| `currentState.authentication` | publicCloud.managedRegistry.Authentication | read-only | Login method applied to the registry. Reported by the service. See Authentication. |
| `currentState.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `currentState.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `currentState.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps | read-only | Authorized IPs. IP filtering applied to the registry. When `rules` is empty or null, any IP is allowed. Reported by the service. See AuthorizedIps. |
| `currentState.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `currentState.name` | string | read-only | Display name applied to the registry. Reported by the service. |
| `currentState.plan` | publicCloud.managedRegistry.PlanEnum | read-only | Plan applied to the registry. Reported by the service. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `currentState.region` | string | read-only | Region where the registry is deployed, for example `EU-WEST-PAR`. Reported by the service. |
| `currentState.url` | string | read-only | URL of the Harbor web interface and registry endpoint, for example `https://xxxxxx.eu-west-par.container-registry.ovh.net`. Null until the registry is deployed. Reported by the service. |
| `currentState.usage` | publicCloud.managedRegistry.Usage | read-only | Resources consumed by the registry. Reported by the service. See Usage. |
| `currentState.usage.artifactStorage` | publicCloud.managedRegistry.ArtifactStorage | read-only | Artifact storage consumed and its limit. Reported by the service. See ArtifactStorage. |
| `currentState.usage.measuredAt` | string (date-time) | read-only | Measured at. Time of the last usage measurement. Null until the first measurement is collected. Reported by the service. |
| `currentState.version` | string | read-only | Harbor version running on the registry, for example `2.14.2`. Reported by the service. |
| `currentTasks` | common.CurrentTask[] | read-only | Current tasks. Asynchronous tasks running on the registry. Empty or null when none is running. Follow `link` to get a task. Reported by the service. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the registry |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Resource status. Readiness of the registry. A new `targetSpec` is accepted only when it is `READY`. Reported by the service. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | read-only | Target specification. Last configuration requested for the registry. Mutable through `PUT .../managedRegistry/{managedRegistryId}`. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |
| `updatedAt` | string (date-time) | read-only | Date of the last update of the registry |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "region": "string",
    "url": "string",
    "usage": {
      "artifactStorage": {
        "limit": {
          "unit": "COUNT",
          "value": 0
        },
        "used": {
          "unit": "COUNT",
          "value": 0
        }
      },
      "measuredAt": "2024-01-01T12:00:00Z"
    },
    "version": "string"
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
  …
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}");

print_r($result);
?>
```

## Update a Managed Private Registry service

`PUT /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#editManagedRegistry

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/edit`

### Asynchronous update

The new `targetSpec` replaces the previous one, the registry moves to `resourceStatus` `UPDATING` and a `REGISTRY_UPDATE` task starts. Poll `GET .../managedRegistry/{managedRegistryId}` until `resourceStatus` is `READY` and `currentState` reflects the change.

### Optimistic concurrency

Send the `checksum` read from the last `GET`. When another update happened in between, the checksums differ and the request is rejected: read the registry again and retry. Omitting `checksum` skips the check.

### Immutable fields

`region` is set at creation and is not part of the update body. Create a new registry to change it.

### Destructive updates

Changing `authentication.type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept.

### Rejected requests

The request is rejected when `resourceStatus` is not `READY`, or when `plan` or `version` is neither the current value nor listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan` or `GET .../managedRegistry/{managedRegistryId}/capabilities/version`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Request body (required)

Type: `publicCloud.managedRegistry.RegistryUpdate`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string |  | Optimistic concurrency token. When set, it must match the `checksum` returned by `GET .../managedRegistry/{managedRegistryId}`, otherwise the request is rejected. When null or empty, the check is skipped and the update overwrites the current `targetSpec`. |
| `targetSpec` | publicCloud.managedRegistry.RegistryUpdateTargetSpec | yes | Target specification. New configuration of the registry, replacing the previous one as a whole. See RegistryUpdateTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Must be the current plan or one listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. Changing it applies the limits and features of the new plan. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.version` | string | yes | Harbor version to run, for example `2.14.2`. Must be the current version or one listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/version`. Changing it upgrades the registry. |

```json
{
  "checksum": "string",
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "version": "string"
  }
}
```

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Registry | successful operation |
| 400 | object | Error 400 response |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Checksum. Hash of the current `targetSpec`. Send it back in `PUT .../managedRegistry/{managedRegistryId}` to detect concurrent updates. Changes on every `targetSpec` update. |
| `createdAt` | string (date-time) | read-only | Creation date of the registry |
| `currentState` | publicCloud.managedRegistry.RegistryCurrentState | read-only | Current state. Configuration applied to the registry. Reported by the service. See RegistryCurrentState. |
| `currentState.authentication` | publicCloud.managedRegistry.Authentication | read-only | Login method applied to the registry. Reported by the service. See Authentication. |
| `currentState.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `currentState.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `currentState.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps | read-only | Authorized IPs. IP filtering applied to the registry. When `rules` is empty or null, any IP is allowed. Reported by the service. See AuthorizedIps. |
| `currentState.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `currentState.name` | string | read-only | Display name applied to the registry. Reported by the service. |
| `currentState.plan` | publicCloud.managedRegistry.PlanEnum | read-only | Plan applied to the registry. Reported by the service. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `currentState.region` | string | read-only | Region where the registry is deployed, for example `EU-WEST-PAR`. Reported by the service. |
| `currentState.url` | string | read-only | URL of the Harbor web interface and registry endpoint, for example `https://xxxxxx.eu-west-par.container-registry.ovh.net`. Null until the registry is deployed. Reported by the service. |
| `currentState.usage` | publicCloud.managedRegistry.Usage | read-only | Resources consumed by the registry. Reported by the service. See Usage. |
| `currentState.usage.artifactStorage` | publicCloud.managedRegistry.ArtifactStorage | read-only | Artifact storage consumed and its limit. Reported by the service. See ArtifactStorage. |
| `currentState.usage.measuredAt` | string (date-time) | read-only | Measured at. Time of the last usage measurement. Null until the first measurement is collected. Reported by the service. |
| `currentState.version` | string | read-only | Harbor version running on the registry, for example `2.14.2`. Reported by the service. |
| `currentTasks` | common.CurrentTask[] | read-only | Current tasks. Asynchronous tasks running on the registry. Empty or null when none is running. Follow `link` to get a task. Reported by the service. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the registry |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Resource status. Readiness of the registry. A new `targetSpec` is accepted only when it is `READY`. Reported by the service. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | read-only | Target specification. Last configuration requested for the registry. Mutable through `PUT .../managedRegistry/{managedRegistryId}`. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |
| `updatedAt` | string (date-time) | read-only | Date of the last update of the registry |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "region": "string",
    "url": "string",
    "usage": {
      "artifactStorage": {
        "limit": {
          "unit": "COUNT",
          "value": 0
        },
        "used": {
          "unit": "COUNT",
          "value": 0
        }
      },
      "measuredAt": "2024-01-01T12:00:00Z"
    },
    "version": "string"
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
  …
```

### Example

```bash
curl -X PUT \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN" \
  -H "content-type: application/json" \
  -d '{ }'
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

# Request body type: publicCloud.managedRegistry.RegistryUpdate
result = client.put("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}",
	checksum = None, # Optimistic concurrency token. When set, it must match the `checksum` returned by `GET .../managedRegistry/{managedRegistryId}`, otherwise the request is rejected. When null or empty, the check is skipped and the update overwrites the current `targetSpec`. (type: string, nullable)
	targetSpec = None, # Target specification. New configuration of the registry, replacing the previous one as a whole. See RegistryUpdateTargetSpec. (type: publicCloud.managedRegistry.RegistryUpdateTargetSpec)
)

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

// Request body type: publicCloud.managedRegistry.RegistryUpdate
$result = $ovh->put("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}", array(
	checksum => null, // Optimistic concurrency token. When set, it must match the `checksum` returned by `GET .../managedRegistry/{managedRegistryId}`, otherwise the request is rejected. When null or empty, the check is skipped and the update overwrites the current `targetSpec`. (type: string, nullable)
	targetSpec => null, // Target specification. New configuration of the registry, replacing the previous one as a whole. See RegistryUpdateTargetSpec. (type: publicCloud.managedRegistry.RegistryUpdateTargetSpec)
));

print_r($result);
?>
```

## Delete a Managed Private Registry service

`DELETE /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#deleteManagedRegistry

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/delete`

Deletion is asynchronous: the registry moves to `resourceStatus` `DELETING`, the response echoes it, and a `REGISTRY_DELETE` task then removes it. Poll `GET .../managedRegistry/{managedRegistryId}` until the registry is no longer returned. Every artifact stored in the registry is deleted and cannot be recovered.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Registry | successful operation |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `checksum` | string | read-only | Checksum. Hash of the current `targetSpec`. Send it back in `PUT .../managedRegistry/{managedRegistryId}` to detect concurrent updates. Changes on every `targetSpec` update. |
| `createdAt` | string (date-time) | read-only | Creation date of the registry |
| `currentState` | publicCloud.managedRegistry.RegistryCurrentState | read-only | Current state. Configuration applied to the registry. Reported by the service. See RegistryCurrentState. |
| `currentState.authentication` | publicCloud.managedRegistry.Authentication | read-only | Login method applied to the registry. Reported by the service. See Authentication. |
| `currentState.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `currentState.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `currentState.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps | read-only | Authorized IPs. IP filtering applied to the registry. When `rules` is empty or null, any IP is allowed. Reported by the service. See AuthorizedIps. |
| `currentState.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `currentState.name` | string | read-only | Display name applied to the registry. Reported by the service. |
| `currentState.plan` | publicCloud.managedRegistry.PlanEnum | read-only | Plan applied to the registry. Reported by the service. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `currentState.region` | string | read-only | Region where the registry is deployed, for example `EU-WEST-PAR`. Reported by the service. |
| `currentState.url` | string | read-only | URL of the Harbor web interface and registry endpoint, for example `https://xxxxxx.eu-west-par.container-registry.ovh.net`. Null until the registry is deployed. Reported by the service. |
| `currentState.usage` | publicCloud.managedRegistry.Usage | read-only | Resources consumed by the registry. Reported by the service. See Usage. |
| `currentState.usage.artifactStorage` | publicCloud.managedRegistry.ArtifactStorage | read-only | Artifact storage consumed and its limit. Reported by the service. See ArtifactStorage. |
| `currentState.usage.measuredAt` | string (date-time) | read-only | Measured at. Time of the last usage measurement. Null until the first measurement is collected. Reported by the service. |
| `currentState.version` | string | read-only | Harbor version running on the registry, for example `2.14.2`. Reported by the service. |
| `currentTasks` | common.CurrentTask[] | read-only | Current tasks. Asynchronous tasks running on the registry. Empty or null when none is running. Follow `link` to get a task. Reported by the service. |
| `currentTasks[].errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `currentTasks[].errors[].message` | string | read-only | Error description |
| `currentTasks[].id` | string (uuid) | read-only | Identifier of the current task |
| `currentTasks[].link` | string | read-only | Link to the task details |
| `currentTasks[].status` | common.CurrentTaskStatusEnum | read-only | Current global status of the current task — one of `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `currentTasks[].type` | string | read-only | Type of the current task |
| `id` | string (uuid) | read-only | Unique identifier of the registry |
| `resourceStatus` | common.ResourceStatusEnum | read-only | Resource status. Readiness of the registry. A new `targetSpec` is accepted only when it is `READY`. Reported by the service. — one of `CREATING`, `CREATION_PLANNED`, `DELETING`, `ERROR`, `OUT_OF_SYNC`, `READY`, `SUSPENDED`, `UNKNOWN`, `UPDATING` |
| `targetSpec` | publicCloud.managedRegistry.RegistryTargetSpec | read-only | Target specification. Last configuration requested for the registry. Mutable through `PUT .../managedRegistry/{managedRegistryId}`. See RegistryTargetSpec. |
| `targetSpec.authentication` | publicCloud.managedRegistry.Authentication |  | Login method of the registry. Changing `type` deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. See Authentication. Defaults to `LOCAL` authentication. |
| `targetSpec.authentication.oidc` | publicCloud.managedRegistry.Oidc |  | OIDC configuration. External OpenID Connect provider users log in with. Required when `type` is `OIDC`, null otherwise. Mutable. See Oidc. |
| `targetSpec.authentication.type` | publicCloud.managedRegistry.AuthenticationTypeEnum | yes | Authentication type. Login method of the registry. Changing it deletes every existing Harbor user of the registry once the update task completes. Robot accounts are kept. — one of `IAM`, `LOCAL`, `OIDC` |
| `targetSpec.authorizedIps` | publicCloud.managedRegistry.AuthorizedIps |  | Authorized IPs. CIDR blocks allowed to reach the registry, per scope. When omitted or when `rules` is empty, any IP is allowed. The rule list is replaced as a whole. See AuthorizedIps. |
| `targetSpec.authorizedIps.rules` | publicCloud.managedRegistry.AuthorizedIpRule[] |  | Rules. CIDR blocks allowed to reach the registry, each on one or more scopes. When empty or null, any IP is allowed. The list is replaced as a whole on update. See AuthorizedIpRule. |
| `targetSpec.name` | string | yes | Display name of the registry. Not an identifier. Renaming has no effect on the registry URL. |
| `targetSpec.plan` | publicCloud.managedRegistry.PlanEnum | yes | Plan of the registry, which sets its storage and request limits and its features. Plans are listed by `GET .../reference/managedRegistry/plan`. Changing it applies the limits and features of the new plan. Plans an existing registry can switch to are listed by `GET .../managedRegistry/{managedRegistryId}/capabilities/plan`. — one of `LARGE`, `MEDIUM`, `SMALL` |
| `targetSpec.region` | string | yes | Region where the registry is deployed. Regions are listed by `GET .../reference/managedRegistry/region`. Immutable after creation. Create a new registry to change it. |
| `targetSpec.version` | string |  | Harbor version to run, for example `2.14.2`. On `POST .../managedRegistry`, must be null or the latest available version: the registry is always created with the latest version. Mutable through `PUT .../managedRegistry/{managedRegistryId}`, which upgrades the registry. |
| `updatedAt` | string (date-time) | read-only | Date of the last update of the registry |

```json
{
  "checksum": "string",
  "createdAt": "2024-01-01T12:00:00Z",
  "currentState": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
        "endpoint": "string",
        "groupFilter": "string",
        "groupsClaim": "string",
        "name": "string",
        "scope": "string",
        "userClaim": "string",
        "verifyCert": true
      },
      "type": "IAM"
    },
    "authorizedIps": {
      "rules": [
        {
          "cidr": "192.0.2.0/24",
          "description": "string",
          "scopes": [
            "ADMINISTRATION"
          ]
        }
      ]
    },
    "name": "string",
    "plan": "LARGE",
    "region": "string",
    "url": "string",
    "usage": {
      "artifactStorage": {
        "limit": {
          "unit": "COUNT",
          "value": 0
        },
        "used": {
          "unit": "COUNT",
          "value": 0
        }
      },
      "measuredAt": "2024-01-01T12:00:00Z"
    },
    "version": "string"
  },
  "currentTasks": [
    {
      "errors": [
        {
          "message": "string"
        }
      ],
      "id": "00000000-0000-0000-0000-000000000000",
      "link": "string",
      "status": "ERROR",
      "type": "string"
    }
  ],
  "id": "00000000-0000-0000-0000-000000000000",
  "resourceStatus": "CREATING",
  "targetSpec": {
    "authentication": {
      "oidc": {
        "adminGroup": "string",
        "autoOnboard": true,
        "clientId": "string",
        "clientSecret": "string",
  …
```

### Example

```bash
curl -X DELETE \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.delete("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->delete("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}");

print_r($result);
?>
```

## Reset the administrator password of a Managed Private Registry service

`POST /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/adminCredentials`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#resetManagedRegistryAdminCredentials

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/adminCredentials/reset`

Generates a new password for the Harbor administrator account and returns it. The previous password stops working immediately. The password is returned only in this response.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Credentials | successful operation |
| 409 | object | Error 409 response |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `password` | string (password) | read-only | New password of the administrator account. The previous password stops working. Returned by the reset call only. |
| `username` | string | read-only | Username of the administrator account |

```json
{
  "password": "string",
  "username": "string"
}
```

### Example

```bash
curl -X POST \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/adminCredentials" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.post("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/adminCredentials")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->post("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/adminCredentials");

print_r($result);
?>
```

## List plans a Managed Private Registry service can switch to

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/plan`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getManagedRegistryPlans

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/capabilities/plan/get`

Any `name` listed can be set as `targetSpec.plan` on `PUT .../managedRegistry/{managedRegistryId}`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Plan[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `features` | publicCloud.managedRegistry.PlanFeatures | read-only | Features included in the plan. See PlanFeatures. |
| `features.vulnerabilityScanner` | boolean | read-only | Whether the plan includes vulnerability scanning of stored artifacts |
| `limits` | publicCloud.managedRegistry.PlanLimits | read-only | Resource limits enforced by the plan. See PlanLimits. |
| `limits.artifactStorage` | publicCloud.managedRegistry.ValueWithUnit | read-only | Maximum storage available for artifacts. See ValueWithUnit. |
| `limits.artifactStorage.unit` | publicCloud.quota.QuotaUnitEnum | read-only | Unit the value is expressed in, for example `GiB` — one of `COUNT`, `GB`, `GiB`, `MB`, `MiB`, `TB`, `TiB` |
| `limits.artifactStorage.value` | integer | read-only | Numeric value in `unit` |
| `limits.parallelRequests` | integer | read-only | Maximum number of requests the registry serves concurrently |
| `name` | publicCloud.managedRegistry.PlanEnum | read-only | Name of the plan, to use as `targetSpec.plan` — one of `LARGE`, `MEDIUM`, `SMALL` |

```json
[
  {
    "features": {
      "vulnerabilityScanner": true
    },
    "limits": {
      "artifactStorage": {
        "unit": "COUNT",
        "value": 0
      },
      "parallelRequests": 0
    },
    "name": "LARGE"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/plan" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/plan")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/plan");

print_r($result);
?>
```

## List Harbor versions a Managed Private Registry service can be upgraded to

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/version`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getManagedRegistryVersions

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/capabilities/version/get`

Only versions available as an upgrade from the version the registry currently runs are listed. To upgrade, set a listed `name` as `targetSpec.version` on `PUT .../managedRegistry/{managedRegistryId}`.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Version[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `changelogUrl` | string | read-only | URL of the Harbor release notes of the version |
| `name` | string | read-only | Harbor version, for example `2.14.2` |

```json
[
  {
    "changelogUrl": "string",
    "name": "string"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/version" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/version")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/capabilities/version");

print_r($result);
?>
```

## List events of a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/event`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getManagedRegistryEvents

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/event/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Event[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the event |
| `kind` | string | read-only | Nature of the event |
| `link` | string | read-only | Link to the event related resource |
| `message` | string | read-only | Description of what happened on the event |
| `type` | common.EventTypeEnum | read-only | Type of the event — one of `TARGET_SPEC_UPDATE`, `TASK_ERROR`, `TASK_START`, `TASK_SUCCESS` |

```json
[
  {
    "createdAt": "2024-01-01T12:00:00Z",
    "kind": "string",
    "link": "string",
    "message": "string",
    "type": "TARGET_SPEC_UPDATE"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/event" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/event")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/event");

print_r($result);
?>
```

## List asynchronous tasks of a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getAllManagedRegistryTasks

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/task/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Task[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the task |
| `errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `errors[].message` | string | read-only | Error description |
| `finishedAt` | string (date-time) | read-only | Ending date of the task |
| `id` | string (uuid) | read-only | Unique identifier of the task |
| `link` | string | read-only | Link to the related resource |
| `message` | string | read-only | Description of the task |
| `progress` | common.TaskProgress[] | read-only | Progress steps of the asynchronous operation |
| `progress[].name` | string | read-only | Progress step name |
| `progress[].status` | common.TaskStatusEnum | read-only | Current status of the progress step — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `startedAt` | string (date-time) | read-only | Starting date of the task |
| `status` | common.TaskStatusEnum | read-only | Current global status of the task — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `type` | string | read-only | Type of the task |
| `updatedAt` | string (date-time) | read-only | Last update of the task |

```json
[
  {
    "createdAt": "2024-01-01T12:00:00Z",
    "errors": [
      {
        "message": "string"
      }
    ],
    "finishedAt": "2024-01-01T12:00:00Z",
    "id": "00000000-0000-0000-0000-000000000000",
    "link": "string",
    "message": "string",
    "progress": [
      {
        "name": "string",
        "status": "DONE"
      }
    ],
    "startedAt": "2024-01-01T12:00:00Z",
    "status": "DONE",
    "type": "string",
    "updatedAt": "2024-01-01T12:00:00Z"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task");

print_r($result);
?>
```

## Get an asynchronous task of a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task/{taskId}`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getManagedRegistryTask

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:managedRegistry/task/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `managedRegistryId` | path | string (uuid) | yes | Managed registry ID |
| `projectId` | path | string | yes | Project ID |
| `taskId` | path | string (uuid) | yes | Task ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | common.Task | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createdAt` | string (date-time) | read-only | Creation date of the task |
| `errors` | common.TaskError[] | read-only | Errors that occurred on the task |
| `errors[].message` | string | read-only | Error description |
| `finishedAt` | string (date-time) | read-only | Ending date of the task |
| `id` | string (uuid) | read-only | Unique identifier of the task |
| `link` | string | read-only | Link to the related resource |
| `message` | string | read-only | Description of the task |
| `progress` | common.TaskProgress[] | read-only | Progress steps of the asynchronous operation |
| `progress[].name` | string | read-only | Progress step name |
| `progress[].status` | common.TaskStatusEnum | read-only | Current status of the progress step — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `startedAt` | string (date-time) | read-only | Starting date of the task |
| `status` | common.TaskStatusEnum | read-only | Current global status of the task — one of `DONE`, `ERROR`, `PENDING`, `RUNNING`, `SCHEDULED`, `WAITING_USER_INPUT` |
| `type` | string | read-only | Type of the task |
| `updatedAt` | string (date-time) | read-only | Last update of the task |

```json
{
  "createdAt": "2024-01-01T12:00:00Z",
  "errors": [
    {
      "message": "string"
    }
  ],
  "finishedAt": "2024-01-01T12:00:00Z",
  "id": "00000000-0000-0000-0000-000000000000",
  "link": "string",
  "message": "string",
  "progress": [
    {
      "name": "string",
      "status": "DONE"
    }
  ],
  "startedAt": "2024-01-01T12:00:00Z",
  "status": "DONE",
  "type": "string",
  "updatedAt": "2024-01-01T12:00:00Z"
}
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task/{taskId}" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task/{taskId}")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/managedRegistry/{managedRegistryId}/task/{taskId}");

print_r($result);
?>
```

## List plans available to create a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/reference/managedRegistry/plan`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getRegistryPlans

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:reference/managedRegistry/plan/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Plan[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `features` | publicCloud.managedRegistry.PlanFeatures | read-only | Features included in the plan. See PlanFeatures. |
| `features.vulnerabilityScanner` | boolean | read-only | Whether the plan includes vulnerability scanning of stored artifacts |
| `limits` | publicCloud.managedRegistry.PlanLimits | read-only | Resource limits enforced by the plan. See PlanLimits. |
| `limits.artifactStorage` | publicCloud.managedRegistry.ValueWithUnit | read-only | Maximum storage available for artifacts. See ValueWithUnit. |
| `limits.artifactStorage.unit` | publicCloud.quota.QuotaUnitEnum | read-only | Unit the value is expressed in, for example `GiB` — one of `COUNT`, `GB`, `GiB`, `MB`, `MiB`, `TB`, `TiB` |
| `limits.artifactStorage.value` | integer | read-only | Numeric value in `unit` |
| `limits.parallelRequests` | integer | read-only | Maximum number of requests the registry serves concurrently |
| `name` | publicCloud.managedRegistry.PlanEnum | read-only | Name of the plan, to use as `targetSpec.plan` — one of `LARGE`, `MEDIUM`, `SMALL` |

```json
[
  {
    "features": {
      "vulnerabilityScanner": true
    },
    "limits": {
      "artifactStorage": {
        "unit": "COUNT",
        "value": 0
      },
      "parallelRequests": 0
    },
    "name": "LARGE"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/reference/managedRegistry/plan" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/reference/managedRegistry/plan")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/reference/managedRegistry/plan");

print_r($result);
?>
```

## List regions available to create a Managed Private Registry service

`GET /v2/publicCloud/project/{projectId}/reference/managedRegistry/region`

Link: https://developers.eu.ovhcloud.com/reference/public-cloud/container/managed-private-registry/#getRegistryRegions

**Status:** Stable production version  
**IAM actions:** `publicCloudProject:apiovh:reference/managedRegistry/region/get`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Pagination-Cursor` | header | string |  | Pagination cursor |
| `X-Pagination-Size` | header | integer |  | Pagination size |
| `projectId` | path | string | yes | Project ID |

### Responses

| Status | Type | Description |
| --- | --- | --- |
| 200 | publicCloud.managedRegistry.Region[] | successful operation |

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | read-only | Region name, to use as `targetSpec.region`, for example `EU-WEST-PAR` |

```json
[
  {
    "name": "string"
  }
]
```

### Example

```bash
curl -X GET \
  "https://api.eu.ovhcloud.com/v2/publicCloud/project/{projectId}/reference/managedRegistry/region" \
  -H "accept: application/json" \
  -H "X-Schemas-Version: 2026-06" \
  -H "authorization: Bearer $OVH_TOKEN"
```

```python
'''
First, install the latest release of Python wrapper: $ pip install ovh
'''
import json
import ovh

# Instantiate an OVH Client.
# You can generate new credentials with full access to your account on
# the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
client = ovh.Client(
	endpoint='ovh-eu',               # Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
	application_key='xxxxxxxxxx',    # Application Key
	application_secret='xxxxxxxxxx', # Application Secret
	consumer_key='xxxxxxxxxx',       # Consumer Key
)

result = client.get("/v2/publicCloud/project/{projectId}/reference/managedRegistry/region")

# Pretty print
print(json.dumps(result, indent=4))
```

```php
<?php
/**
 * First, download the latest release of PHP wrapper on github
 * And include this script into the folder with extracted files
 */
require __DIR__ . '/vendor/autoload.php';
use \Ovh\Api;

/**
 * Instantiate an OVH Client.
 * You can generate new credentials with full access to your account on
 * the token creation page (https://api.ovh.com/createToken/index.cgi?GET=/*&PUT=/*&POST=/*&DELETE=/*)
 */
$ovh = new Api('xxxxxxxxxx',  // Application Key
               'xxxxxxxxxx',  // Application Secret
               'ovh-eu',      // Endpoint of API OVH (List of available endpoints: https://github.com/ovh/python-ovh#2-configure-your-application)
               'xxxxxxxxxx'); // Consumer Key

$result = $ovh->get("/v2/publicCloud/project/{projectId}/reference/managedRegistry/region");

print_r($result);
?>
```
