Aliases

Quick navigation

GET Aliases

Purpose

Returns a list of requestable managed account aliases.

Required roles

Requestor or Requestor/Approver role for the preferred managed account referenced by the alias.

Query parameters

  • state (optional, default: 1, 2): Zero or more state values, i.e., 'state=2', 'state=1,2', 'state=0,1,2'.
    • 0: Unmapped
    • 1: Mapped
    • 2: Highly Available

Only Aliases with a mapped state of 1 or 2 can be used for API POST Aliases/{id}/Requests.

Request body

None.

Response body

Content-Type: application/json

[
    {
        AliasId: int,
        AliasName: string,
        AliasState: int,
        SystemId: int,
        SystemName: string,
        AccountId: int,
        AccountName: string,
        DomainName: string,
        InstanceName: string,
        DefaultReleaseDuration: int,
        MaximumReleaseDuration: int,
        LastChangeDate: datetime,
        NextChangeDate: datetime,
        IsChanging: bool,
        ChangeState: int,

        MappedAccounts :
        [
            {
                AliasID: int,
                ManagedSystemID: int,
                ManagedAccountID: int,
                Status: string
            },
            …
        ]
    }
    …
]

Response codes

200 - Request successful. Aliases in response body.

For more information, please see Common response codes.

GET Aliases/{id}

Purpose

Returns a requestable managed account alias by ID.

Required roles

Requestor or Requestor/Approver role for the preferred managed account referenced by the alias.

URL parameters

id: ID of the managed account alias.

Request body

None.

Response body

Content-Type: application/json

{
    AliasId: int,
    AliasName: string,
    AliasState: int,
    SystemId: int,
    SystemName: string,
    AccountId: int,
    AccountName: string,
    DomainName: string,
    InstanceName: string,
    DefaultReleaseDuration: int,
    MaximumReleaseDuration: int,
    LastChangeDate: datetime,
    NextChangeDate: datetime,
    IsChanging: bool,
    ChangeState: int,

    MappedAccounts :
    [
        {
            AliasID: int,
            ManagedSystemID: int,
            ManagedAccountID: int,
            Status: string
        },
        …
    ]
}

Response codes

200 - Request successful. Alias in response body.

For more information, please see Common response codes.

GET Aliases?name={name}

Purpose

Returns a requestable managed account alias by name.

Required roles

Requestor or Requestor/Approver role for the preferred managed account referenced by the alias.

URL parameters

name: Name of the managed account alias.

Request body

None.

Response body

Content-Type: application/json

{
    AliasId: int,
    AliasName: string,
    AliasState: int,
    SystemId: int,
    SystemName: string,
    AccountId: int,
    AccountName: string,
    DomainName: string,
    InstanceName: string,
    DefaultReleaseDuration: int,
    MaximumReleaseDuration: int,
    LastChangeDate: datetime,
    NextChangeDate: datetime,
    IsChanging: bool,
    ChangeState: int,

    MappedAccounts :
    [
        {
            AliasID: int,
            ManagedSystemID: int,
            ManagedAccountID: int,
            Status: string
        },
        …
    ]
}

Response codes

200 - Request successful. Alias in response body.

For more information, please see Common response codes.