Manage account profiles - Get user members by role
Obtém um segmento de membros de usuário de uma função limitado a um tamanho específico.
GET https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembersGET https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers?size={size}&sortField={sortField}&sortDirection={sortDirection}&seekOperation={seekOperation}Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
role_id
|
path | True |
string |
O identificador de função. |
|
version
|
path | True |
string |
Versão da API. |
|
seek
|
query |
string |
A operação de busca a ser executada nos membros do usuário da função. Isso é útil em cenários de paginação em que as próximas páginas ou as páginas anteriores dos membros do usuário são necessárias. |
|
|
size
|
query |
integer int32 |
O número máximo de membros de usuário a serem retornados, o valor não deve ser superior a 500 e não deve ser inferior a 1 |
|
|
sort
|
query |
string |
Um parâmetro de classificação opcional para a direção a ser classificada, os valores aceitos são crescentes e decrescentes, o padrão é Crescente |
|
|
sort
|
query |
string |
Um parâmetro de classificação opcional para o campo a ser classificado, os valores aceitos são DisplayName e UserPrincipalName, o padrão é UserPrincipalName. |
Cabeçalho da solicitação
| Nome | Obrigatório | Tipo | Description |
|---|---|---|---|
| Authorization | True |
string |
Token de portador de autorização |
| Accept | True |
string |
Tipo de conteúdo aceitável; aplicativo/json de tipo amplamente accepeted |
| ms-correlationid |
string |
Usado para acompanhar solicitações internamente. Se um ms-correlationid não for fornecido, o servidor gerará um novo para cada solicitação |
|
| ms-requestid |
string |
Usado para idempotency de solicitações. Se uma ms-requestid não for fornecida, o servidor gerará uma nova para cada solicitação |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A solicitação foi bem-sucedida. O corpo da resposta contém a lista de membros do usuário. Media Types: "application/json", "text/json" |
|
| 400 Bad Request |
Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro. Media Types: "application/json", "text/json" |
|
| 401 Unauthorized |
A solicitação não foi autenticada. Primeiro, o cliente precisa se autenticar com o serviço de API do parceiro. Media Types: "application/json", "text/json" |
|
| 403 Forbidden |
A solicitação foi autenticada, mas foi recusada, pois o chamador não tem os direitos de invocá-la. Media Types: "application/json", "text/json" |
|
| 404 Not Found |
O recurso não foi encontrado ou não está disponível com os parâmetros de entrada especificados. Media Types: "application/json", "text/json" |
|
| 500 Internal Server Error |
O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir isso. Media Types: "application/json", "text/json" |
Definições
| Nome | Description |
|---|---|
|
Microsoft. |
Contém uma coleção de recursos com propriedades JSON para representar a saída |
|
Microsoft. |
O link representa um URI e o método HTTP que indica a ação desejada para acessar o recurso. |
|
Microsoft. |
Refere-se aos atributos de objeto comuns |
|
Microsoft. |
Links de navegação para o recurso |
|
Microsoft. |
Descreve as informações de membro de um usuário. |
|
System. |
Microsoft.Partner.Sdk.Contracts.V1.Collections.ResourceCollection[Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember]
Contém uma coleção de recursos com propriedades JSON para representar a saída
| Nome | Tipo | Description |
|---|---|---|
| attributes |
Microsoft. |
Obtém os atributos. |
| items |
Microsoft. |
Obtém os itens da coleção. |
| links |
Obtém ou define os links. |
|
| totalCount |
integer |
Obtém a contagem total. |
Microsoft.Partner.Sdk.Contracts.V1.Common.Link
O link representa um URI e o método HTTP que indica a ação desejada para acessar o recurso.
| Nome | Tipo | Description |
|---|---|---|
| headers |
System. |
Obtém os cabeçalhos de link. |
| method |
string |
O método. |
| uri |
string |
O URI. |
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes
Refere-se aos atributos de objeto comuns
| Nome | Tipo | Description |
|---|---|---|
| etag |
string |
Obtém ou define a etag. A versão do objeto em provedores. |
| objectType |
string |
O tipo de objeto. |
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceLinks
Links de navegação para o recurso
| Nome | Tipo | Description |
|---|---|---|
| next |
A próxima página de itens. |
|
| previous |
A página anterior dos itens. |
|
| self |
O auto-uri. |
Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember
Descreve as informações de membro de um usuário.
| Nome | Tipo | Description |
|---|---|---|
| accountId |
string |
Obtém ou define a ID da conta em que a atribuição de função está vinculada. |
| attributes |
Microsoft. |
Obtém os atributos. |
| displayName |
string |
Obtém ou define o nome de exibição do usuário. |
| id |
string |
O identificador do membro. |
| roleId |
string |
O identificador da função do usuário. |
| userPrincipalName |
string |
Obtém ou define o nome da entidade de segurança do usuário. |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Nome | Tipo | Description |
|---|---|---|
| key |
string |
|
| value |
string |