Skip to content

Removal markdown classes {.external} in KB Manage and operate #8245

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: develop
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-asia.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).

* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

Expand Down Expand Up @@ -55,7 +55,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-au.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).

* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

Expand Down Expand Up @@ -55,7 +55,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-ca.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).

* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

Expand Down Expand Up @@ -55,7 +55,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-gb.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).
* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

## Instructions
Expand Down Expand Up @@ -54,7 +54,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-ie.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).
* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

## Instructions
Expand Down Expand Up @@ -54,7 +54,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-sg.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).

* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

Expand Down Expand Up @@ -55,7 +55,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.en-us.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,8 @@ This guide will also show you how to add one or more logins to this sub-account

## Requirements

* Being connected on [OVHcloud API](/links/api){.external}.
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps){.external}.
* Being connected on [OVHcloud API](/links/api).
* Having [created your credentials for OVHcloud API](/pages/manage_and_operate/api/first-steps).

* Having a customer account wih Reseller Tag (contact your sales representative for eligibility if applicable).

Expand Down Expand Up @@ -55,7 +55,7 @@ With the previously created ConsumerKey.

* email : add an email address for this user
* login : enter a relevant string for this user
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external}.
* password : it must meet the requirements of [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) and be valid by testing it on [Pwned Passwords](https://haveibeenpwned.com/Passwords).

## Go further

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.fr-ca.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ Ce guide vous permettra aussi d'ajouter un ou des logins a ce sous-compte pour l

## Prérequis

* Être connecté aux [API OVHcloud](/links/api){.external}.
* Avoir [créé ses identifiants pour l'API OVHcloud](/pages/manage_and_operate/api/first-steps){.external}.
* Être connecté aux [API OVHcloud](/links/api).
* Avoir [créé ses identifiants pour l'API OVHcloud](/pages/manage_and_operate/api/first-steps).
* Avoir un compte client avec un tag Reseller (Contactez votre commercial pour connaitre votre éligibilité le cas échéant).

## En pratique
Expand Down Expand Up @@ -55,7 +55,7 @@ Avec la ConsumerKey précédemment obtenue

* email : ajoutez une adresse mail pour cet utilisateur
* login : renseignez une chaîne de caractères
* password : celui-ci doit répondre aux exigences de [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} et être valide en le testant sur [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external} .
* password : celui-ci doit répondre aux exigences de [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) et être valide en le testant sur [Pwned Passwords](https://haveibeenpwned.com/Passwords) .

## Aller plus loin

Expand Down
6 changes: 3 additions & 3 deletions pages/manage_and_operate/api/account/guide.fr-fr.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ Ce guide vous permettra aussi d'ajouter un ou des logins a ce sous-compte pour l

## Prérequis

* Être connecté aux [API OVHcloud](/links/api){.external}.
* Avoir [créé ses identifiants pour l'API OVHcloud](/pages/manage_and_operate/api/first-steps){.external}.
* Être connecté aux [API OVHcloud](/links/api).
* Avoir [créé ses identifiants pour l'API OVHcloud](/pages/manage_and_operate/api/first-steps).
* Avoir un compte client avec un tag Reseller (Contactez votre commercial pour connaitre votre éligibilité le cas échéant).

## En pratique
Expand Down Expand Up @@ -55,7 +55,7 @@ Avec la ConsumerKey précédemment obtenue

* email : ajoutez une adresse mail pour cet utilisateur
* login : renseignez une chaîne de caractères
* password : celui-ci doit répondre aux exigences de [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn){.external} et être valide en le testant sur [Pwned Passwords](https://haveibeenpwned.com/Passwords){.external} .
* password : celui-ci doit répondre aux exigences de [zxcvbn: Low-Budget Password Strength Estimation](https://github.com/dropbox/zxcvbn) et être valide en le testant sur [Pwned Passwords](https://haveibeenpwned.com/Passwords) .

## Aller plus loin

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ As an example, let's assume that you want to create a marketplace in which you,

The first part, as the application developer, is to register your application on OVHcloud.

To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/){.external}.
To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/).

You will need to log in and set an application name and description.

Expand Down Expand Up @@ -111,5 +111,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ As an example, let's assume that you want to create a marketplace in which you,

The first part, as the application developer, is to register your application on OVHcloud.

To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/){.external}.
To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/).

You will need to log in and set an application name and description.

Expand Down Expand Up @@ -111,5 +111,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ As an example, let's assume that you want to create a marketplace in which you,

The first part, as the application developer, is to register your application on OVHcloud.

To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/){.external}.
To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/).

You will need to log in and set an application name and description.

Expand Down Expand Up @@ -111,5 +111,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -112,5 +112,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -112,5 +112,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ As an example, let's assume that you want to create a marketplace in which you,

The first part, as the application developer, is to register your application on OVHcloud.

To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/){.external}.
To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/).

You will need to log in and set an application name and description.

Expand Down Expand Up @@ -111,5 +111,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ As an example, let's assume that you want to create a marketplace in which you,

The first part, as the application developer, is to register your application on OVHcloud.

To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/){.external}.
To do so, go to [OVHcloud API](https://ca.api.ovh.com/createApp/).

You will need to log in and set an application name and description.

Expand Down Expand Up @@ -111,5 +111,5 @@ Happy development !

## Go further

- [API Console](/links/api){.external}
- [API Console](/links/api)

Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Par exemple, supposons que vous voulez créer un marché dans lequel vous, en ta

La première partie, en tant que développeur d'applications, consiste à enregistrer votre application sur OVHcloud.

Pour ce faire, accédez à l'[API OVHcloud](https://ca.api.ovh.com/createApp/){.external}
Pour ce faire, accédez à l'[API OVHcloud](https://ca.api.ovh.com/createApp/)

Vous devrez vous connecter et définir un nom et une description de l'application.

Expand Down
16 changes: 8 additions & 8 deletions pages/manage_and_operate/api/apiv2/guide.de-de.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,11 @@ updated: 2023-04-17

## Objective

The APIs available at [https://eu.api.ovh.com/](/links/api){.external} allow you to buy, manage, update and configure OVHcloud products without using a graphical interface like the OVHcloud Control Panel.
The APIs available at [https://eu.api.ovh.com/](/links/api) allow you to buy, manage, update and configure OVHcloud products without using a graphical interface like the OVHcloud Control Panel.

Historically, OVHcloud APIs have been available under the **/1.0** branch corresponding to the first version of the API that we published.

A new section of the OVHcloud APIs is available under the prefix **/v2** on [https://eu.api.ovh.com/v2](https://api.ovh.com/console-preview/?branch=v2){.external}.
A new section of the OVHcloud APIs is available under the prefix **/v2** on [https://eu.api.ovh.com/v2](https://api.ovh.com/console-preview/?branch=v2).

This new branch will bring together new API routes, reworked in a new format, and become the main API branch for new feature developments of OVHcloud products.<br>
The **/1.0** branch will continue to exist in parallel to the **/v2** branch but will not contain the same functionality. As a customer, you can consume APIs from branch **/1.0** and **/v2** simultaneously in your programs, while retaining the same authentication and tools to call the API. To standardise the naming of our API branches, the **/1.0** branch is also available via the **/v1** alias.
Expand Down Expand Up @@ -52,7 +52,7 @@ When a major new version is released, we will evaluate the impact of this new ve

#### Retrieve available versions via the console

You can see the list of versions available on the OVHcloud API console. To do this, open the [console](https://api.ovh.com/console-preview/?section=%2Fiam&branch=v2#servers){.external}.
You can see the list of versions available on the OVHcloud API console. To do this, open the [console](https://api.ovh.com/console-preview/?section=%2Fiam&branch=v2#servers).

The different versions are displayed in the **SCHEMAS VERSION** section. You can then select a version to view the associated API schemas.

Expand All @@ -65,9 +65,9 @@ There are two opposing approaches to seeing the current state of a resource thro
- **Process-centred approach**: The API exposes the current state of resources (for example, a Public Cloud instance) and offers operations for modifying them (for example, changing the size of a disk).
- **Resource-centred approach**: The API exposes both the current state of resources and the desired state. Changes are made directly by updating the desired state of the resources. In this case, the API takes the necessary actions itself to reach the targeted state.

The first approach is the one used by the current API: [https://eu.api.ovh.com/v1](https://eu.api.ovh.com/v1){.external}.
The first approach is the one used by the current API: [https://eu.api.ovh.com/v1](https://eu.api.ovh.com/v1).

The APIv2 uses the resource-centric approach, which makes it easier to use *as-code*, particularly with tools like [Terraform](https://www.terraform.io){.external}. This operation also abstracts all the complexity of the process of transforming a resource from one state to another since it is the responsibility of the API and not the customer.
The APIv2 uses the resource-centric approach, which makes it easier to use *as-code*, particularly with tools like [Terraform](https://www.terraform.io). This operation also abstracts all the complexity of the process of transforming a resource from one state to another since it is the responsibility of the API and not the customer.

### Asynchronous management and events

Expand Down Expand Up @@ -155,9 +155,9 @@ The absence of the `X-Pagination-Cursor-Next` header in an API response containi

Several libraries are available to use the OVHcloud APIs:

- Go: [https://github.com/ovh/go-ovh](https://github.com/ovh/go-ovh){.external}
- Python: [https://github.com/ovh/python-ovh](https://github.com/ovh/python-ovh){.external}
- PHP: [https://github.com/ovh/php-ovh](https://github.com/ovh/php-ovh){.external}
- Go: [https://github.com/ovh/go-ovh](https://github.com/ovh/go-ovh)
- Python: [https://github.com/ovh/python-ovh](https://github.com/ovh/python-ovh)
- PHP: [https://github.com/ovh/php-ovh](https://github.com/ovh/php-ovh)

## Go further <a name="gofurther"></a>

Expand Down
Loading