Policies - Update Customer

Service:

Billing

API-versie:

2020-05-01

Hiermee werkt u het beleid voor een klant bij. Deze bewerking wordt alleen ondersteund voor factureringsaccounts met het overeenkomsttype Microsoft Partner-overeenkomst.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/policies/default?api-version=2020-05-01

URI-parameters

Name	In	Vereist	Type	Description
billingAccountName	path	True	string	De id waarmee een factureringsrekening uniek wordt geïdentificeerd.
customerName	path	True	string	De id waarmee een klant uniek wordt geïdentificeerd.
api-version	query	True	string	De versie van de API die moet worden gebruikt met de clientaanvraag. De huidige versie is 2020-05-01.

Aanvraagbody

Name	Type	Description
properties.viewCharges	ViewCharges	Het beleid waarmee wordt bepaald of de gebruikers in de organisatie van de klant kosten kunnen bekijken tegen betalen per gebruik-prijzen.

Antwoorden

Name	Type	Description
200 OK	CustomerPolicy	OK. De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

UpdateCustomer

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/policies/default?api-version=2020-05-01

{
  "properties": {
    "viewCharges": "NotAllowed"
  }
}

Java

import com.azure.resourcemanager.billing.fluent.models.CustomerPolicyInner;
import com.azure.resourcemanager.billing.models.ViewCharges;

/** Samples for Policies UpdateCustomer. */
public final class Main {
    /*
     * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdateCustomerPolicy.json
     */
    /**
     * Sample code: UpdateCustomer.
     *
     * @param manager Entry point to BillingManager.
     */
    public static void updateCustomer(com.azure.resourcemanager.billing.BillingManager manager) {
        manager
            .policies()
            .updateCustomerWithResponse(
                "{billingAccountName}",
                "{customerName}",
                new CustomerPolicyInner().withViewCharges(ViewCharges.NOT_ALLOWED),
                com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.billing import BillingManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-billing
# USAGE
    python update_customer.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = BillingManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.policies.update_customer(
        billing_account_name="{billingAccountName}",
        customer_name="{customerName}",
        parameters={"properties": {"viewCharges": "NotAllowed"}},
    )
    print(response)


# x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdateCustomerPolicy.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armbilling_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/billing/armbilling"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/7a2ac91de424f271cf91cc8009f3fe9ee8249086/specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdateCustomerPolicy.json
func ExamplePoliciesClient_UpdateCustomer() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armbilling.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewPoliciesClient().UpdateCustomer(ctx, "{billingAccountName}", "{customerName}", armbilling.CustomerPolicy{
		Properties: &armbilling.CustomerPolicyProperties{
			ViewCharges: to.Ptr(armbilling.ViewChargesNotAllowed),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.CustomerPolicy = armbilling.CustomerPolicy{
	// 	Name: to.Ptr("default"),
	// 	Type: to.Ptr("Microsoft.Billing/billingAccounts/customers/policies"),
	// 	ID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/policies/default"),
	// 	Properties: &armbilling.CustomerPolicyProperties{
	// 		ViewCharges: to.Ptr(armbilling.ViewChargesNotAllowed),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { BillingManagementClient } = require("@azure/arm-billing");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Updates the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
 *
 * @summary Updates the policies for a customer. This operation is supported only for billing accounts with agreement type Microsoft Partner Agreement.
 * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdateCustomerPolicy.json
 */
async function updateCustomer() {
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const billingAccountName = "{billingAccountName}";
  const customerName = "{customerName}";
  const parameters = { viewCharges: "NotAllowed" };
  const credential = new DefaultAzureCredential();
  const client = new BillingManagementClient(credential, subscriptionId);
  const result = await client.policies.updateCustomer(billingAccountName, customerName, parameters);
  console.log(result);
}

updateCustomer().catch(console.error);

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/policies/default",
  "name": "default",
  "type": "Microsoft.Billing/billingAccounts/customers/policies",
  "properties": {
    "viewCharges": "NotAllowed"
  }
}

Definities

Name	Description
CustomerPolicy	Het beleid van de klant.
ErrorDetails	De details van de fout.
ErrorResponse	Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.
ErrorSubDetails
ViewCharges	Het beleid waarmee wordt bepaald of de gebruikers in de organisatie van de klant kosten kunnen bekijken tegen betalen per gebruik-prijzen.

CustomerPolicy

Object

Het beleid van de klant.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.viewCharges	ViewCharges	Het beleid waarmee wordt bepaald of de gebruikers in de organisatie van de klant kosten kunnen bekijken tegen betalen per gebruik-prijzen.
type	string	Resourcetype.

ErrorDetails

Object

De details van de fout.

Name	Type	Description
code	string	Foutcode.
details	ErrorSubDetails[]	De subdetails van de fout.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.
target	string	Het doel van de specifieke fout.

ErrorResponse

Object

Foutreactie geeft aan dat de service de binnenkomende aanvraag niet kan verwerken. De reden is opgegeven in het foutbericht.

Name	Type	Description
error	ErrorDetails	De details van de fout.

ErrorSubDetails

Object

Name	Type	Description
code	string	Foutcode.
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.
target	string	Het doel van de specifieke fout.

ViewCharges

Inventarisatie

Het beleid waarmee wordt bepaald of de gebruikers in de organisatie van de klant kosten kunnen bekijken tegen betalen per gebruik-prijzen.

Waarde	Description
Allowed
NotAllowed