Replaces policy members

PUT 
https://apis.<domain>/iam/policies/:id/members

Replaces the entire member list of a specific policy with a new list. Use this endpoint to update members of either custom or compiuta-managed policies.

Ensure each element of the members array is in the correct format.

Authorization Action:

iam:policyMembers:update

Request

Path Parameters

id stringrequired

ID of the policy.

application/json

Bodyrequired

membersstring[]

List of members that replaces previous policy member list.

Responses

200

A successful response.

application/json

Schema

Schema

membersstring[]

Resulting list of policy members.

Example (auto)

{
  "members": [
    "team:local:viewers",
    "user:local:test"
  ]
}

default

An unexpected error response.

application/json

Schema

Schema

codeinteger<int32>
messagestring
details object[]
Array [
@typestring
property name*any
]

Example (auto)

{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://apis.<domain>/iam/policies/:id/members");
request.Headers.Add("Accept", "application/json");
var content = new StringContent("{\n  \"members\": [\n    \"team:local:viewers\",\n    \"user:local:test\"\n  ]\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://apis.<domain>

Parameters

id — pathrequired

Body required

{
  "members": [
    "team:local:viewers",
    "user:local:test"
  ]
}