Contact UsGet started

SAML Federation API, gRPC: FederationService.ListUserAccounts

Written by
Updated at November 7, 2024

Lists users for the specified federation.

gRPC request

rpc ListUserAccounts (ListFederatedUserAccountsRequest) returns (ListFederatedUserAccountsResponse)

ListFederatedUserAccountsRequest

{
  "federationId": "string",
  "pageSize": "int64",
  "pageToken": "string",
  "filter": "string"
}

Field

Description

federationId

string

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

pageSize

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.

filter

string

A filter expression that filters resources listed in the response.
The expression must specify:

  1. The field name. Currently you can use filtering only on the nameId field.
  2. An = operator.
  3. The value in double quotes ("). Must be 1-1000 characters long and match the regular expression
    [a-z0-9A-Z/@_.\-=+*\\]+.

ListFederatedUserAccountsResponse

{
  "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
    }
  ],
  "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.

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
DeleteUserAccounts
Next
ListOperations