Updates the external user relations for the named security policy.
Base Request
PUT /api/repository/security/policies/[policyName]/externaluserrelations
where [policyName] is the name of the security policy.
Headers
| Header Name | Description | Required | Values |
|---|---|---|---|
| Authorization | The access token | Required |
Bearer [access_token]
where [access_token] is a string generated when you complete authentication (see Getting Started) |
| User-Agent | Identity of the client making the request to the server | Required |
[product]/[version]
where [product] is the name of the software you are using to make the request and [version] is the numbered version of the software (for example, MyCompanyProduct/1.0). For information on other types of values commonly included in user-agent request headers, see the User-Agent HTTP header reference section on the Mozilla developer documentation website. |
| HXCS-REPOSITORY | The repository ID | Optional | Any contributed repository name. Default is default. |
| Content-Type | The format of the data to be posted | Optional | application/json |
Request Body
| Element | Description | Type | Required | Notes |
|---|---|---|---|---|
| additionalProp1 | Placeholder example of a non-system property that can be added to supplement the system properties. | Defined by the user. | Optional | None |
Sample Request
PUT /api/repository/security/policies/[policyName]/externaluserrelations Authorization: Bearer [access_token] User-Agent: MyCompanyProduct/1.0 HXCS-REPOSITORY: default Content-Type: application/json { "additionalProp1": [ { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } ], "additionalProp2": [ { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } ], "additionalProp3": [ { "additionalProp1": {}, "additionalProp2": {}, "additionalProp3": {} } ] }
Response
No response body is returned.
Status Codes and Errors
The following table lists the returned status codes.
| Code | Description | Notes |
|---|---|---|
| 204 | No Content | The provided external user relations configuration has been applied. |
| 400 | Bad Request | The server could not process the request due to an invalid payload for the external user relations configuration. |
| 401 | Not Authorized | Authentication has failed or was not provided. |
| 403 | Not Allowed | Access permissions are invalid or missing. |
| 404 | Not Found | The repository or the external user relations policy could not be found. |