Skip to main content

MachineAccountMappingsApi

All URIs are relative to https://sailpoint.api.identitynow.com

MethodHTTP requestDescription
create-machine-account-mappings-v1POST /sources/v1/{sourceId}/machine-account-mappingsCreate machine account mappings
delete-machine-account-mappings-v1DELETE /sources/v1/{sourceId}/machine-account-mappingsDelete source's machine account mappings
list-machine-account-mappings-v1GET /sources/v1/{sourceId}/machine-account-mappingsMachine account mapping for source
set-machine-account-mappings-v1PUT /sources/v1/{sourceId}/machine-mappingsUpdate source's machine account mappings

create-machine-account-mappings-v1

Create machine account mappings Creates Machine Account Mappings for both identities and accounts for a source. A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
attributemappingsAttributemappings

Return type

Array<Attributemappings>

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import { MachineAccountMappingsApi } from 'sailpoint-api-client';
import { Configuration } from 'sailpoint-api-client';
import { Attributemappings } from 'sailpoint-api-client/dist/machine_account_mappings/api';

const configuration = new Configuration();
const apiInstance = new MachineAccountMappingsApi(configuration);
const sourceId: string = ef38f94347e94562b5bb8424a56397d8; // Source ID.
const attributemappings: Attributemappings = ; //
const result = await apiInstance.createMachineAccountMappingsV1({ sourceId: sourceId, attributemappings: attributemappings });
console.log(result);

[Back to top]

delete-machine-account-mappings-v1

Delete source's machine account mappings Use this API to remove machine account attribute mappings for a Source. A token with ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

NameTypeDescriptionNotes
sourceIdstringsource ID.[default to undefined]

Return type

(empty response body)

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import { MachineAccountMappingsApi } from 'sailpoint-api-client';
import { Configuration } from 'sailpoint-api-client';

const configuration = new Configuration();
const apiInstance = new MachineAccountMappingsApi(configuration);
const sourceId: string = ef38f94347e94562b5bb8424a56397d8; // source ID.
const result = await apiInstance.deleteMachineAccountMappingsV1({ sourceId: sourceId });
console.log(result);

[Back to top]

list-machine-account-mappings-v1

Machine account mapping for source Retrieves Machine account mappings for a specified source using Source ID.

API Spec

Parameters

NameTypeDescriptionNotes
sourceIdstringSource ID[default to undefined]
limitnumberMax number of results to return. See V3 API Standard Collection Parameters for more information.[optional] [default to 250]
offsetnumberOffset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.[optional] [default to 0]

Return type

Array<Attributemappings>

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

Example

import { MachineAccountMappingsApi } from 'sailpoint-api-client';
import { Configuration } from 'sailpoint-api-client';

const configuration = new Configuration();
const apiInstance = new MachineAccountMappingsApi(configuration);
const sourceId: string = ef38f94347e94562b5bb8424a56397d8; // Source ID
const limit: number = 250; // Max number of results to return. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const offset: number = 0; // Offset into the full result set. Usually specified with *limit* to paginate through the results. See [V3 API Standard Collection Parameters](https://developer.sailpoint.com/idn/api/standard-collection-parameters) for more information. (optional)
const result = await apiInstance.listMachineAccountMappingsV1({ sourceId: sourceId });
console.log(result);

[Back to top]

set-machine-account-mappings-v1

Update source's machine account mappings Use this API to update Machine Account Attribute Mapping for a Source. A token with ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

API Spec

Parameters

NameTypeDescriptionNotes
sourceIdstringSource ID.[default to undefined]
attributemappingsAttributemappings

Return type

Array<Attributemappings>

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

Example

import { MachineAccountMappingsApi } from 'sailpoint-api-client';
import { Configuration } from 'sailpoint-api-client';
import { Attributemappings } from 'sailpoint-api-client/dist/machine_account_mappings/api';

const configuration = new Configuration();
const apiInstance = new MachineAccountMappingsApi(configuration);
const sourceId: string = ef38f94347e94562b5bb8424a56397d8; // Source ID.
const attributemappings: Attributemappings = ; //
const result = await apiInstance.setMachineAccountMappingsV1({ sourceId: sourceId, attributemappings: attributemappings });
console.log(result);

[Back to top]