directoryobject: getAvailableExtensionPropertiesdirectoryObject: getAvailableExtensionProperties

Namespace: microsoft.graphNamespace: microsoft.graph

Retorna todas ou uma lista filtrada das propriedades de extensão de diretório que foram registradas em um diretório.Return all or a filtered list of the directory extension properties that have been registered in a directory. As seguintes entidades dão suporte a propriedades de extensão: User, Group, Organization, Device, Applicatione servicePrincipalName.The following entities support extension properties: user, group, organization, device, application, and servicePrincipal.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (de privilégios máximos a mínimos)Permissions (from most to least privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Directory.Read.AllDirectory.Read.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Directory.Read.AllDirectory.Read.All

Solicitação HTTPHTTP request

POST /directoryObjects/getAvailableExtensionProperties

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/json. Obrigatório.application/json. Required.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON dos parâmetros.In the request body, supply JSON representation of the parameters.

A tabela a seguir mostra os parâmetros que podem ser usados com esta ação.The following table shows the parameters that can be used with this action.

ParâmetroParameter TipoType DescriçãoDescription
isSyncedFromOnPremisesisSyncedFromOnPremises BooleanBoolean true para especificar que somente as propriedades de extensão sincronizadas a partir do diretório local devem ser retornadas; false para especificar que somente as propriedades de extensão que não são sincronizadas a partir do diretório local devem ser retornadas.true to specify that only extension properties that are synced from the on-premises directory should be returned; false to specify that only extension properties that are not synced from the on-premises directory should be returned. Se o parâmetro for omitido, todas as propriedades de extensão (sincronizadas e não sincronizadas) serão retornadas.If the parameter is omitted, all extension properties (both synced and non-synced) are returned.

RespostaResponse

Se tiver êxito, esta ação retornará um 200 OK código de resposta e uma coleção extensionproperty no corpo da resposta.If successful, this action returns a 200 OK response code and an extensionProperty collection in the response body.

ExemplosExamples

SolicitaçãoRequest

POST https://graph.microsoft.com/v1.0/directoryObjects/getAvailableExtensionProperties

Content-Type: application/json
Content-length: 43

{
  "isSyncedFromOnPremises": "Boolean"
}

RespostaResponse

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.extensionProperty",
      "id": "d6a8bfec-893d-46e4-88fd-7db5fcc0fa62",
      "deletedDateTime": null,
      "appDisplayName": "SampleApp",
      "name": "extension_4d405aa8baa04fb494d3e0571fd9fd71_skypeId",
      "dataType": "String",
      "isSyncedFromOnPremises": false,
      "targetObjects": [
        "User"
      ]
    }
  ]
}