Compartir a través de

Obtención de una organización de clientes

  • Artículo

Se aplica a: Centro de partners

Obtiene un recurso de organización del cliente.

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite credenciales o autenticación de app+user.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners. Seleccione el área de trabajo Clientes en la página principal del Centro de partners. Seleccione el cliente en la lista Customer (Cliente) y, a continuación, seleccione Account (Cuenta). En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Detalles de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

Importante

Los roles de GDAP son necesarios para llamar a esta API. NO se admite DAP.

Roles de GDAP

Necesitará al menos uno de los siguientes roles de GDAP:

  • Escritor de directorios
  • Lector global

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-tenant-id}/organization HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de consulta para un cliente específico.

Nombre Type Obligatorio Descripción
customer-tenant-id guid Y El valor es un GUID con formato customer-tenant-id que permite al revendedor filtrar los resultados de un cliente determinado que pertenece al revendedor.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

Respuesta REST

Si se ejecuta correctamente, este método devuelve un recurso Customer en el cuerpo de la respuesta.

Códigos de error y de respuesta correctos

Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

Contenido relacionado