Contact UsGet started
© 2024 Iron Hive LLC Belgrade

Identity and Access Management SAML API, REST: Federation.ListUserAccounts

Written by
Updated at November 7, 2024

Lists users for the specified federation.

HTTP request

GET https://iam.api.cloud.yandex.net/iam/v1/saml/federations/{federationId}:listUserAccounts

Path parameters

Field

Description

federationId

string

Required field. ID of the federation to list user accounts for.

Query parameters

Field

Description

pageSize

string (int64)

The maximum number of results per page to return. If the number of available
results is larger than pageSize, the service returns a ListFederatedUserAccountsResponse.nextPageToken
that can be used to get the next page of results in subsequent list requests.
Default value: 100.

pageToken

string

Page token. To get the next page of results, set pageToken
to the ListFederatedUserAccountsResponse.nextPageToken
returned by a previous list request.

Response

HTTP Code: 200 - OK

{
  "userAccounts": [
    {
      "id": "string",
      // Includes only one of the fields `yandexPassportUserAccount`, `samlUserAccount`
      "yandexPassportUserAccount": {
        "login": "string",
        "defaultEmail": "string"
      },
      "samlUserAccount": {
        "federationId": "string",
        "nameId": "string",
        "attributes": {
          "value": [
            "string"
          ]
        }
      },
      // end of the list of possible fields
      "lastAuthenticatedAt": "string"
    }
  ],
  "nextPageToken": "string"
}

Field

Description

userAccounts[]

UserAccount

List of user accounts for the specified federation.

nextPageToken

string

This token allows you to get the next page of results for list requests. If the number of results
is larger than ListFederatedUserAccountsRequest.pageSize, use the nextPageToken as the value
for the ListFederatedUserAccountsRequest.pageToken query parameter in the next list request.
Each subsequent list request will have its own nextPageToken to continue paging through the results.

UserAccount

Currently represents only Yandex account.

Field

Description

id

string

ID of the user account.

yandexPassportUserAccount

YandexPassportUserAccount

A YandexPassportUserAccount resource.

Includes only one of the fields yandexPassportUserAccount, samlUserAccount.

samlUserAccount

SamlUserAccount

A SAML federated user.

Includes only one of the fields yandexPassportUserAccount, samlUserAccount.

lastAuthenticatedAt

string (date-time)

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

YandexPassportUserAccount

A YandexPassportUserAccount resource.
For more information, see Yandex account.

Field

Description

login

string

Login of the Yandex user account.

defaultEmail

string

Default email of the Yandex user account.

SamlUserAccount

A SAML federated user.
For more information, see federations.

Field

Description

federationId

string

Required field. ID of the federation that the federation belongs to.

nameId

string

Required field. Name Id of the SAML federated user.
The name is unique within the federation. 1-256 characters long.

attributes

Attribute

Additional attributes of the SAML federated user.

Attribute

Field

Description

value[]

string
Previous
AddUserAccounts
Next
ListOperations