Obter uma configuração de diretórioGet a directory setting

• 04/03/2021
• 2 minutos para o fim da leitura
• • a
  • o

Namespace: microsoft.graphNamespace: microsoft.graph

Recupere as propriedades de um objeto de configuração de diretório específico.Retrieve the properties of a specific directory setting object.

Observação: a versão /beta dessa API só se aplica a grupos.Note: The /beta version of this API only applies to groups. A versão /v1.0 dessa API foi renomeada para Get groupSettings.The /v1.0 version of this API has been renamed to Get groupSettings.

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.

Solicitação HTTPHTTP request

Obter uma configuração específica de locatário ou grupoGet a specific tenant-wide or group setting

GET /settings/{id}
GET /groups/{id}/settings/{id}

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um código 200 OK de resposta e um objeto directorySetting no corpo da resposta.If successful, this method returns a 200 OK response code and directorySetting object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

GET https://graph.microsoft.com/beta/settings/{id}

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var directorySetting = await graphClient.Settings["{directorySetting-id}"]
    .Request()
    .GetAsync();

const options = {
    authProvider,
};

const client = Client.init(options);

let directorySetting = await client.api('/settings/{id}')
    .version('beta')
    .get();

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/settings/{id}"]]];
[urlRequest setHTTPMethod:@"GET"];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        MSGraphDirectorySetting *directorySetting = [[MSGraphDirectorySetting alloc] initWithData:data error:&nserror];

}];

[meDataTask execute];

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

DirectorySetting directorySetting = graphClient.settings("{id}")
    .buildRequest()
    .get();

RespostaResponse

Veja a seguir um exemplo da resposta. Observação: o objeto response mostrado aqui pode estar truncado por motivos de concisão. Todas as propriedades serão retornadas de uma chamada real.Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 198

{
  "id": "id-value",
  "displayName": "displayName-value",
  "settingTemplateId": "settingTemplateId-value",
  "values": [
    {
      "name": "name-value",
      "value": "value-value"
    }
  ]
}