Identity and Access Management SAML API, REST: Federation.AddUserAccounts
Adds users to the specified federation.
HTTP request
POST https://iam.api.cloud.yandex.net/iam/v1/saml/federations/{federationId}:addUserAccounts
Path parameters
Field |
Description |
federationId |
string Required field. ID of the federation to add users. |
Body parameters
{
"nameIds": [
"string"
]
}
Field |
Description |
nameIds[] |
string Name IDs returned by the Identity Provider (IdP) on successful authentication. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"description": "string",
"createdAt": "string",
"createdBy": "string",
"modifiedAt": "string",
"done": "boolean",
"metadata": {
"federationId": "string"
},
// Includes only one of the fields `error`, `response`
"error": {
"code": "integer",
"message": "string",
"details": [
"object"
]
},
"response": {
"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
}
]
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
Field |
Description |
id |
string ID of the operation. |
description |
string Description of the operation. 0-256 characters long. |
createdAt |
string (date-time) Creation timestamp. String in RFC3339 To work with values in this field, use the APIs described in the |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
string (date-time) The time when the Operation resource was last modified. String in RFC3339 To work with values in this field, use the APIs described in the |
done |
boolean If the value is |
metadata |
AddFederatedUserAccountsMetadata Service-specific metadata associated with the operation. |
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
response |
AddFederatedUserAccountsResponse The normal response of the operation in case of success. Includes only one of the fields The operation result. |
AddFederatedUserAccountsMetadata
Field |
Description |
federationId |
string ID of the federation that is being altered. |
Status
The error result of the operation in case of failure or cancellation.
Field |
Description |
code |
integer (int32) Error code. An enum value of google.rpc.Code |
message |
string An error message. |
details[] |
object A list of messages that carry the error details. |
AddFederatedUserAccountsResponse
Field |
Description |
userAccounts[] |
List of users created by FederationService.AddUserAccounts request. |
UserAccount
Currently represents only Yandex account.
Field |
Description |
id |
string ID of the user account. |
yandexPassportUserAccount |
A YandexPassportUserAccount resource. Includes only one of the fields |
samlUserAccount |
A SAML federated user. Includes only one of the fields |
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. |
attributes |
Additional attributes of the SAML federated user. |
Attribute
Field |
Description |
value[] |
string |