Crie um cliente do Azure CSPCreate an Azure CSP customer

Antes de poder acessar as informações de suporte ou faturamento de um cliente ou fazer pedidos para um cliente, você deve criar o cliente no sistema.Before you can access a customer's support or billing information or place orders for a customer, you must create the customer in the system. Quando você cria um cliente, você também cria:When you create a customer, you also create:

  • Um objeto de inquilino do Azure AD (Azure Active Directory) para o cliente.An Azure Active Directory (Azure AD) tenant object for the customer.
  • Um relacionamento entre o revendedor e o cliente, que é usado para privilégios de administrador delegado.A relationship between the reseller and customer, which is used for delegated administrator privileges.
  • Um nome de usuário e senha para entrar como administrador do cliente.A username and password for signing in as an administrator for the customer.

Interface do usuário da WebWeb UI

  1. No painel da Microsoft Partner Center, no painel esquerdo, selecione Clientes e, em seguida, selecione Adicionar cliente.On the Microsoft Partner Center dashboard, in the left pane, select Customers, and then select Add customer.

    O botão "Adicionar cliente"

  2. No formulário Informações da conta, insira as informações da conta do cliente.On the Account info form, enter the customer's account information.

    O formulário "Informações de conta"

    Importante

    Só é possível escolher um País/região que se encontra na lista de países/regiões disponíveis para o mercado no qual você se registrou como parceiro do CSP.You can choose Country/region only among the list of countries/regions that are available for the market where you've enrolled as a CSP Partner. Se você estiver autorizado em um único país ou região (por exemplo, EUA, Canadá ou Brasil), não será possível alterar o país ou a região durante o processo de criação do novo cliente.If you are authorized in a single country or region (for example, US, Canada, or Brazil), you can't change the country or region during new customer creation process. Para obter mais informações, consulte Autorização regional do CSP.For more information, see CSP regional authorization.

  3. Selecione Avançar: Assinaturas.Select Next: Subscriptions.

  4. Marque as caixas de seleção ao lado de Microsoft Azure e de quaisquer outras ofertas desejadas e, em seguida, selecione o número de licenças para cada oferta, quando aplicável.Select the check boxes next to Microsoft Azure and any other offers you want, and then select the number of licenses for each offer, where applicable.

    Observação

    Existem separadores separados para ofertas empresariais, de pequenas empresas e governamentais.There are separate tabs for enterprise, small business, and government offers. Verifique se você está usando a guia de ofertas Enterprise.Make sure you're using the Enterprise offers tab.

    Lista de ofertas

  5. Selecione Avançar: Análise.Select Next: Review.

  6. Examine o cliente e detalhes da oferta.Review the customer and offer details. Para fazer alterações, selecione o link Atualização correspondente.To make changes, select the corresponding Update link. Caso contrário, selecione Enviar.Otherwise, select Submit.

    A janela de revisão

  7. Na janela de confirmação, observe as informações da conta do usuário Administrador e Senha.In the confirmation window, note the Admin user account and Password information. As informações não poderão ser visualizadas depois que você sair dessa página, então faça uma cópia delas e armazene-as para enviá-las ao cliente.The information won't be viewable after you leave this page, so copy and store it to send to the customer.

    A janela de confirmação

    Importante

    Por padrão, o administrador do cliente não tem acesso a essa assinatura do Azure e não pode gerenciá-la usando o Portal do Azure.By default, the customer administrator does not have access to this Azure subscription and cannot manage it by using the Azure portal. O modelo CSP foi projetado para uma variedade de cenários e, em alguns deles (por exemplo, Managed Cloud Services), o cliente não precisa acessar o portal do Azure.The CSP model was designed for a variety of scenarios, and in some of them (for example, Managed Cloud Services) the customer doesn't need to access the Azure portal. O parceiro do CSP gerencia os recursos do cliente.The CSP partner manages the customer's resources instead. Se você quiser conceder ao cliente acesso à assinatura do CSP do Azure, será necessário um passo adicional.If you want to grant the customer access to the Azure CSP subscription, an additional step is required.

  8. Selecione Concluído.Select Done.

  9. No painel do Partner Center, selecione Clientes, selecione o cliente que você criou, selecione Gerenciamento de serviços e, em seguida, Portal de Gerenciamento do Microsoft Azure.On the Partner Center dashboard, select Customers, select the customer that you created, select Service management, and then select Microsoft Azure Management Portal.

    O link do portal clássico do Azure
    O portal do Azure abre.The Azure portal opens.

  10. Para adicionar o cliente como um proprietário da assinatura do Azure, consulte Atribuir permissões a uma assinatura do Azure CSP.To add the customer as an owner of the Azure subscription, see Assign permissions to an Azure CSP subscription.

    No painel do portal do Azure

Observação

Uma conta de cliente do CSP pode ter várias assinaturas do CSP do Azure.One CSP customer account can have multiple Azure CSP subscriptions. Por padrão, todas as assinaturas são denominadas Microsoft Azure.By default, all subscriptions are named Microsoft Azure. Para melhor distingui-los, renomeie-os na Central de parceiros para algo mais descritivo (por exemplo, Ambiente de produção ou Sistema de RH).To better distinguish them, rename them in Partner Center to something more descriptive (for example, Production environment or HR System).

PowerShellPowerShell

Use o seguinte comando para criar um novo cliente com o PowerShell.Use the following command to create a new customer with PowerShell. Para aprender a configurar o ambiente do PowerShell para o CSP do Azure, consulte Opções de gerenciamento do Azure CSP.To learn how to configure the PowerShell environment for Azure CSP, see Azure CSP management options.

$newDefaultAddress = New-PCCustomerDefaultAddress -Country '<country code>' -Region '<region>' -City '<city>' -State '<state>' -AddressLine1 '<address1>' -PostalCode <postal code> -FirstName '<first name>' -LastName '<last name>' -PhoneNumber <phone number>

$newBillingProfile = New-PCCustomerBillingProfile -Email '<email>' -Culture '<ex: en.us>' -Language '<ex: en>' -CompanyName '<company name>' -DefaultAddress $newDefaultAddress

$newCompanyProfile = New-PCCustomerCompanyProfile -Domain '<company name>.onmicrosoft.com'

$newCustomer = New-PCCustomer -BillingProfile $newBillingProfile -CompanyProfile $newCompanyProfile

C#C#

Para adicionar um cliente, conclua as seguintes etapas:To add a customer, complete the following steps:

  1. Instancie um novo objeto Cliente.Instantiate a new Customer object.
  2. Preencha as informações BillingProfile e CompanyProfile.Fill in the BillingProfile and CompanyProfile information.
  3. Adicione o objeto à sua coleção IAggregatePartners.Customers chamando Create () ou CreateAsync () .Add the object to your IAggregatePartners.Customers collection by calling Create() or CreateAsync().
// IAggregatePartner partnerOperations;
var partnerOperations = this.Context.UserPartnerOperations;

var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture, 
            "SampleApplication{0}.{1}", 
            new Random().Next(), 
            this.Context.Configuration.Scenario.CustomerDomainSuffix)
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "en-us",
        Email = "marshall@fourthcoffee.com",
        Language = "en",
        CompanyName = "Fourth Coffee" + new Random().Next(),
        DefaultAddress = new Address()
        {
            FirstName = "Marshall",
            LastName = "Levi",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",

Country = "US",
            PostalCode = "98052",
            PhoneNumber = "1234567890"
        }
    }
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

API RESTREST API

As informações a seguir são um guia para formatar uma solicitação para adicionar um cliente usando a API REST.The following information is a guide to formatting a request to add a customer by using the REST API.

SolicitaçãoRequest

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
POSTPOST {baseURI}/v1/customers HTTP/1.1{baseURI}/v1/customers HTTP/1.1

Cabeçalhos da solicitaçãoRequest headers

  • Essa API não produzirá resultados diferentes se for chamada várias vezes.This API won't produce different results if it's called multiple times.
  • ID de solicitação e ID de correlação são obrigatórios.Request ID and correlation ID are required.

Corpo da solicitaçãoRequest body

O corpo da solicitação possui as seguintes propriedades necessárias:The request body has the following required properties:

NOMEName TypeType DESCRIÇÃODescription
BillingProfileBillingProfile objetoobject As informações do perfil de faturamento do cliente.The customer's billing profile information.
CompanyProfileCompanyProfile objetoobject Informações do perfil da empresa do cliente.The customer's company profile information.

Perfil de cobrançaBilling profile

Os recursos do CustomerBillingProfile necessários para criar um novo cliente possuem os seguintes campos obrigatórios:The CustomerBillingProfile resources needed to create a new customer have the following minimum required fields:

NOMEName TypeType DESCRIÇÃODescription
emailemail stringstring O endereço de email do cliente.The customer's email address.
cultureculture stringstring A cultura preferida do cliente para comunicação e moeda, como "en-US".The customer's preferred culture for communication and currency, such as "en-US."
Linguagemlanguage stringstring O idioma padrão.The default language. Há suporte para códigos de idioma de dois caracteres (en, fr e assim por diante).Two-character language codes (en, fr, and so on) are supported.
COMPANY_NAMEcompany_name stringstring O nome da empresa ou organização registrado.The registered company or organization name.
default_addressdefault_address endereçoaddress O endereço registrado da empresa ou a organização do cliente.The registered address of the customer's company or organization.

Perfil da empresaCompany profile

O recurso CustomerCompanyProfile necessário para criar um novo cliente possui o seguinte campo obrigatório:The CustomerCompanyProfile resource needed to create a new customer has the following minimum required field:

NOMEName TypeType DESCRIÇÃODescription
domíniodomain stringstring O nome de domínio do cliente, como contoso.onmicrosoft.com.The customer's domain name, such as contoso.onmicrosoft.com.

Exemplo de solicitaçãoRequest example

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token> 
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "Id": null,
    "CommerceId": null,
    "CompanyProfile": {
        "TenantId": null,
        "Domain": "SampleApplication1047419322.onmicrosoft.com",
        "CompanyName": null,
        "Attributes": {
            "ObjectType": "CustomerCompanyProfile"
        }
    },
    "BillingProfile": {
        "Id": null,
        "FirstName": null,
        "LastName": null,
        "Email": "marshall@fourthcoffee.com",
        "Culture": "en-us",
        "Language": "en",
        "CompanyName": "Fourth Coffee",
        "DefaultAddress": {
            "Country": "US",
            "Region": null,
            "City": "Redmond",
            "State": "WA",
            "AddressLine1": "One Microsoft Way",
            "AddressLine2": null,
            "PostalCode": "98052",
            "FirstName": "Marshall",
            "LastName": "Levi",
            "PhoneNumber": "1234567890"
        },
        "Attributes": {
            "ObjectType": "CustomerBillingProfile"
        }
    },
    "RelationshipToPartner": "none",
    "AllowDelegatedAccess": null,
    "UserCredentials": null,
    "CustomDomains": null,
    "AssociatedPartnerId": null,
    "Attributes": {
        "ObjectType": "Customer"
    }
}

ResponseResponse

Se a solicitação for bem-sucedida, essa API retornará um recurso do cliente para o novo cliente.If the request is successful, this API returns a customer resource for the new customer. Salve o ID do cliente e os detalhes do Azure AD para uso futuro, como o gerenciamento de contas.Save the customer ID and Azure AD details for future use, such as account management.

Exemplo de respostaResponse example

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT

 {
    "id": "dfd8cc0a-c592-468c-8461-869a38d24738",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "dfd8cc0a-c572-468c-8461-869a38d24734",
        "domain": "SampleApplication1047419322.onmicrosoft.com",
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
        "email": "marshall@fourthcoffee.com",
        "culture": "en-us",
        "language": "en",
        "companyName": "Fourth Coffee",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Marshall",
            "lastName": "Levi",
            "phoneNumber": "1234567890"
        },
        "attributes": {
            "etag": "1234567890",
            "objectType": "CustomerBillingProfile"
        }
    },
    "relationshipToPartner": "none",
    "userCredentials": {
        "userName": "admin",
        "password": "P@ssword12345"
    },
    "attributes": {
        "objectType": "Customer"
    }
}

Próximas etapasNext steps