Listar parceiros
Namespace: microsoft.graph
Obtenha uma lista de todas as configurações de parceiros dentro de uma política de acesso entre locatários. Você também pode usar o $expand
parâmetro para listar a política de sincronização do usuário para todas as configurações do parceiro.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegada (conta corporativa ou de estudante) | Policy.Read.All | Policy.ReadWrite.CrossTenantAccess |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Policy.Read.All | Policy.ReadWrite.CrossTenantAccess |
Solicitação HTTP
GET /policies/crossTenantAccessPolicy/partners
Parâmetros de consulta opcionais
Esse método dá suporte aos $select
parâmetros de $expand
consulta E OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e uma coleção de objetos crossTenantAccessPolicyConfigurationPartner no corpo da resposta.
Exemplos
Exemplo 1: Listar todas as configurações de parceiro dentro de uma política de acesso entre locatários
O exemplo a seguir mostra como listar todas as configurações de parceiros dentro de uma política de acesso entre locatários.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"tenantId": "123f4846-ba00-4fd7-ba43-dac1f8f63013",
"inboundTrust": null,
"isInMultiTenantOrganization": false,
"automaticUserConsentSettings": {
"inboundAllowed": null,
"outboundAllowed": null
},
"b2bCollaborationInbound": null,
"b2bCollaborationOutbound": null,
"b2bDirectConnectOutbound": null,
"b2bDirectConnectInbound": {
"usersAndGroups": {
"accessType": "allowed",
"targets": [
{
"target": "AllUsers",
"targetType": "user"
}
]
},
"applications": {
"accessType": "allowed",
"targets": [
{
"target": "Office365",
"targetType": "application"
}
]
}
},
"tenantRestrictions": {
"usersAndGroups": {
"accessType": "blocked",
"targets": [
{
"target": "AllUsers",
"targetType": "user"
}
]
},
"applications": {
"accessType": "blocked",
"targets": [
{
"target": "AllApplications",
"targetType": "application"
}
]
}
}
}
]
}
Exemplo 2: listar a política de sincronização do usuário para todas as configurações de parceiro
O exemplo a seguir usa o $expand
parâmetro para listar a política de sincronização do usuário para todas as configurações do parceiro.
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/policies/crossTenantAccessPolicy/partners?$select=tenantId&$expand=identitySynchronization
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
"identitySynchronization": {
"tenantId": "9c5d131d-b1c3-4fc4-9e3f-c6557947d551",
"displayName": "Fabrikam",
"userSyncInbound": {
"isSyncAllowed": true
}
}
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários