Skip to content

Commit a7a09d5

Browse files
committed
Updating IAM guide and Managing Contact guide with cross-account feature
1 parent 3135aac commit a7a09d5

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+529
-136
lines changed

pages/account_and_service_management/account_information/iam-policies-api/guide.de-de.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Verwendung von IAM-Richtlinien mit der OVHcloud API (EN)
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-asia.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-au.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-ca.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-gb.md

Lines changed: 80 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,84 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Conditions
361+
362+
It is possible to add conditions to policies. The policy will only be valid if the conditions are met.
363+
Conditions are added to an access policy in the following form:
364+
365+
```json
366+
{
367+
"operator": "AND",
368+
"conditions": [
369+
{
370+
"operator": "MATCH",
371+
"values": {
372+
"resource.Tag(environment)": "prod",
373+
"resource.Type": "dnsZone"
374+
}
375+
},
376+
{
377+
"operator": "NOT",
378+
"conditions": [
379+
{
380+
"operator": "MATCH",
381+
"values": {
382+
"date(Europe/Paris).WeekDay.IN": "Saturday,Sunday"
383+
}
384+
}
385+
]
386+
}
387+
]
388+
}
389+
```
390+
391+
For example, a policy with this condition is valid if the targeted resources are of type **dnsZone** with the tag **"environment:prod"**, except on **Saturday and Sunday** in the Paris time zone.
392+
393+
The operator field specifies how the conditions will be evaluated:
394+
395+
- **AND**: All conditions must be validated
396+
- **NOT**: None of the conditions must be validated
397+
- **OR**: At least one condition must be validated
398+
- **MATCH**: Condition evaluation operator
399+
400+
The available conditions are:
401+
402+
| Condition | Operator | Data Type | Description | Example |
403+
| :--------------------: | :--------------------------------------------------------: | :--------: | :--------------------------------: | :-----------------------------------------: |
404+
| date(location).Date | EQ <br>BEFORE <br>AFTER <br>IN | YYYY-MM-DD | Filter on calendar days | "date.Date(America/New_York)": "2024-12-25" |
405+
| date(location).Hour | EQ <br>BEFORE <br>AFTER <br>GE <br>LE <br>GT <br>LT <br>IN | int | Filter on hours | "date(Europe/Paris).Hour.IN" : "7,8,9" |
406+
| date(location).WeekDay | EQ <br>BEFORE <br>AFTER <br>GE <br>LE <br>GT <br>LT <br>IN | string | Filter on days of the week | "date(Europe/Berlin).WeekDay.AFTER": "monday" |
407+
| resource.Tag(tag_key) | EQ <br>STARTS_WITH <br>ENDS_WITH | string | Filter on tags | "resource.Tag(environment): "dev" |
408+
| resource.Name | EQ <br>IN <br>STARTS_WITH <br>ENDS_WITH | string | Filter on resource names | "resource.Name.Start_with": "vps-" |
409+
| resource.Type | EQ <br>IN <br>STARTS_WITH <br>ENDS_WITH | string | Filter on resource types | "resource.Type.In": "dnsZone,vps" |
410+
| request.IP | EQ <br>IN <br>IN_RANGE | IP v4 | Filter on client source IP | "request.IP.IN_RANGE": "10.23.0.0/16" |
411+
412+
Dates use time zones based on [IANA database names](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If not specified, the date will be evaluated in UTC time zone.
413+
414+
The available operators for condition types are:
415+
416+
- **EQ**: The value must exactly match the specified value
417+
- **BEFORE** or **LT** (less than): The value must be strictly less than
418+
- **AFTER** or **GE** (greater or equal): The value must be equal to or greater than
419+
- **GT** (greater than): The value must be strictly greater than
420+
- **LE** (less or equal): The value must be equal to or less than
421+
- **IN**: The value must be included in the list
422+
- **START_WITH**: The value must start with the specified value
423+
- **END_WITH**: The value must end with the specified value
424+
- **IN_RANGE**: The value must be in the specified IP subnet
425+
426+
If not specified, the default operator is **EQ**.
427+
428+
#### Policies targeting other OVHcloud customer accounts
429+
430+
Access policies can target other OVHcloud customer accounts.
431+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
432+
433+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
434+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
435+
436+
Access to the support will still be reserved to the owner of the resource.
437+
360438
### Identities
361439

362440
Policies apply to users, which can be accounts, users or user groups.
@@ -723,4 +801,4 @@ Here is a part of the output:
723801

724802
## Go further
725803

726-
Join our [community of users](/links/community).
804+
Join our [community of users](/links/community).

pages/account_and_service_management/account_information/iam-policies-api/guide.en-ie.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-sg.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.en-us.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: How to use IAM policies using the OVHcloud API
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.es-es.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Cómo utilizar las políticas de IAM con la API de OVHcloud (EN)"
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

pages/account_and_service_management/account_information/iam-policies-api/guide.es-us.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Cómo utilizar las políticas de IAM con la API de OVHcloud (EN)"
33
excerpt: "Find out how to give specific access rights to users from an OVHcloud account"
4-
updated: 2025-07-17
4+
updated: 2025-08-18
55
---
66

77
## Objective
@@ -357,6 +357,16 @@ The available operators for condition types are:
357357

358358
If not specified, the default operator is **EQ**.
359359

360+
#### Policies targeting other OVHcloud customer accounts
361+
362+
Access policies can target other OVHcloud customer accounts.
363+
The targeted account of this policy will be able to manage the rights received that way on its own policies, but will never be able to override the rights set on the access policy.
364+
365+
For example, an account **xx1111-ovh** gives rights on `vps:apiovh:ips/*` to account **xx2222-ovh**:
366+
Account **xx2222-ovh** will be able to give the right `vps:apiovh:ips/delete` to its own users, but will never be able to grant the right `vps:apiovh:reboot`.
367+
368+
Access to the support will still be reserved to the owner of the resource.
369+
360370
### Identities
361371

362372
Policies apply to users, which can be accounts, users or user groups.

0 commit comments

Comments
 (0)