Identity & Access Management

Preview — pending review

This reference is generated from the platform API contract and is still under review. Operations, fields, and descriptions can change before publication.

Dry run — OpenStack credentials a grant change would revoke

POST
/scopes/{scopeId}/iam/users/{userId}/actions/preview-openstack-credential-impact

Answers which of the member's ACTIVE OpenStack API credentials the platform would delete if the proposed change were made: a credential dies when the roles baked into it are no longer all held (implied roles included) on its project under the member's projected Keystone roles. Nothing is changed: the change is applied inside a rolled-back savepoint — no grant, no cloud call, no event. change: disable / remove (the member loses every role: every active credential is listed). A change of the member's access matrix is previewed by POST /tenants/{tenantId}/iam/users/{userId}/access/actions/preview-openstack-credential-impact. Only credentials the member's current projection covers are listed (one already uncovered is deleted by the next reconcile regardless of this change). Authorization: the same as the change itself — iam: manage on the scope (owner); 403 otherwise. Errors: 401; 403; 404 unknown scope or user; 422 validation.

Authorization

bearerToken
headerAuthorizationBearer <token>

An API token (pc_live_…) or a service-account key (sak_live_…), created in Identity & Access Management and sent as Authorization: Bearer <token>. Requests are rate limited per credential and per tenant: every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and a refused request gets 429 RATE_LIMITED with Retry-After.

Path Parameters

scopeId*string

Opaque ownership+authorization scope resolving to tenant + subscription + project.

userId*string

Identifier of the IAM user whose grants would change.

Request Body

application/json
  1. body

A proposed member lifecycle change (disable / remove).

change*OpenStackCredentialImpactChange

The grant change to preview.

Value in"disable""remove"

Response Body

The credentials the change would revoke (empty when none).

application/json
  1. response
data*array<>
curl -X POST "https://example.com/scopes/string/iam/users/string/actions/preview-openstack-credential-impact" \  -H "Content-Type: application/json" \  -d '{    "change": "disable"  }'
{  "data": [    {      "id": "string",      "name": "string",      "projectId": "string",      "profile": "full"    }  ]}