Partilhar via

Obter a política de configuração de um cliente

Aplica-se a: Centro de Parceiros

Como obter a política de configuração especificada para o cliente especificado.

Pré-requisitos

  • Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais autónomas da Aplicação e da Aplicação+Utilizador.

  • Um ID de cliente (customer-tenant-id). Se não souber o ID do cliente, pode procurá-lo no Centro de Parceiros selecionando a área de trabalho Clientes e, em seguida, o cliente na lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure o ID Microsoft na secção Informações da Conta de Cliente . O ID da Microsoft é o mesmo que o ID do cliente (customer-tenant-id).

  • O identificador de política.

C#

Para obter uma política de configuração para o cliente especificado, chame primeiro o método IAggregatePartner.Customers.ById com o ID do cliente para obter uma interface para operações no cliente especificado. Em seguida, chame o método ConfigurationPolicies.ById com o ID de política para obter uma interface para operações de política de configuração para a política especificada. Por fim, chame o método Get ou GetAsync para obter a política de configuração.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedConfigurationPolicyId;

ConfigurationPolicy retrievedConfigurationPolicy =
    partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedConfigurationPolicyId).Get();

Exemplo: aplicação de teste da consola. Project: Classe de Exemplos do SDK do Centro de Parceiros: GetConfigurationPolicy.cs

Pedido REST

Sintaxe do pedido

Método URI do pedido
GET {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Parâmetro URI

Utilize o seguinte caminho e parâmetros de consulta ao criar o pedido.

Nome Tipo Necessário Descrição
customer-id string Yes Uma cadeia formatada por GUID que identifica o cliente.
policy-id string Yes Uma cadeia formatada por GUID que identifica a política.

Cabeçalhos do pedido

Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.

Corpo do pedido

Nenhuma

Exemplo de pedido

GET https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Host: api.partnercenter.microsoft.com

Resposta do REST

Se for bem-sucedida, a resposta contém o recurso ConfigurationPolicy pedido.

Códigos de erro e êxito da resposta

Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro REST do Centro de Parceiros.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 443
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: ab3abfe7-dce7-46c0-ab20-4fd49bc3e2f7
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:08:27 GMT

{
    "id": "56edf752-ee77-4fd8-b7f5-df1f74a3a9ac",
    "name": "Test policy",
    "category": "o_o_b_e",
    "description": "Test policy creation from API 1",
    "devicesAssigned": 0,
    "policySettings": ["skip_express_settings"],
    "createdDate": "2017-07-25T11:03:03.8457116-07:00",
    "lastModifiedDate": "2017-07-25T11:04:00.8149974-07:00",
    "attributes": {
        "objectType": "ConfigurationPolicy"
    }
}
  • Last updated on