Policies - Update

Odwołanie

Service:: Billing

API Version:: 2020-05-01

Aktualizacje zasady profilu rozliczeniowego. Ta operacja jest obsługiwana tylko w przypadku kont rozliczeniowych z typem umowy Umowa z Klientem Microsoft.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
billingAccountName	path	True	string	Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.
billingProfileName	path	True	string	Identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2020-05-01.

Treść żądania

Nazwa	Typ	Opis
properties.marketplacePurchases	MarketplacePurchasesPolicy	Zasady, które określają, czy zakupy w witrynie Azure Marketplace są dozwolone dla profilu rozliczeniowego.
properties.reservationPurchases	ReservationPurchasesPolicy	Zasady, które określają, czy zakupy rezerwacji platformy Azure są dozwolone dla profilu rozliczeniowego.
properties.viewCharges	ViewChargesPolicy	Zasady, które kontrolują, czy użytkownicy z dostępem RBAC platformy Azure do subskrypcji mogą wyświetlać swoje opłaty.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Policy	OK. Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

UpdatePolicy

Sample Request

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

{
  "properties": {
    "marketplacePurchases": "OnlyFreeAllowed",
    "reservationPurchases": "NotAllowed",
    "viewCharges": "Allowed"
  }
}

import com.azure.resourcemanager.billing.fluent.models.PolicyInner;
import com.azure.resourcemanager.billing.models.MarketplacePurchasesPolicy;
import com.azure.resourcemanager.billing.models.ReservationPurchasesPolicy;
import com.azure.resourcemanager.billing.models.ViewChargesPolicy;

/** Samples for Policies Update. */
public final class Main {
    /*
     * x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdatePolicy.json
     */
    /**
     * Sample code: UpdatePolicy.
     *
     * @param manager Entry point to BillingManager.
     */
    public static void updatePolicy(com.azure.resourcemanager.billing.BillingManager manager) {
        manager
            .policies()
            .updateWithResponse(
                "{billingAccountName}",
                "{billingProfileName}",
                new PolicyInner()
                    .withMarketplacePurchases(MarketplacePurchasesPolicy.ONLY_FREE_ALLOWED)
                    .withReservationPurchases(ReservationPurchasesPolicy.NOT_ALLOWED)
                    .withViewCharges(ViewChargesPolicy.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

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

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-billing
# USAGE
    python update_policy.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(
        billing_account_name="{billingAccountName}",
        billing_profile_name="{billingProfileName}",
        parameters={
            "properties": {
                "marketplacePurchases": "OnlyFreeAllowed",
                "reservationPurchases": "NotAllowed",
                "viewCharges": "Allowed",
            }
        },
    )
    print(response)


# x-ms-original-file: specification/billing/resource-manager/Microsoft.Billing/stable/2020-05-01/examples/UpdatePolicy.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

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/UpdatePolicy.json
func ExamplePoliciesClient_Update() {
	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().Update(ctx, "{billingAccountName}", "{billingProfileName}", armbilling.Policy{
		Properties: &armbilling.PolicyProperties{
			MarketplacePurchases: to.Ptr(armbilling.MarketplacePurchasesPolicyOnlyFreeAllowed),
			ReservationPurchases: to.Ptr(armbilling.ReservationPurchasesPolicyNotAllowed),
			ViewCharges:          to.Ptr(armbilling.ViewChargesPolicyAllowed),
		},
	}, 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.Policy = armbilling.Policy{
	// 	Name: to.Ptr("default"),
	// 	Type: to.Ptr("Microsoft.Billing/billingAccounts/billingProfiles/policies"),
	// 	ID: to.Ptr("/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/policies/default"),
	// 	Properties: &armbilling.PolicyProperties{
	// 		MarketplacePurchases: to.Ptr(armbilling.MarketplacePurchasesPolicyOnlyFreeAllowed),
	// 		ReservationPurchases: to.Ptr(armbilling.ReservationPurchasesPolicyNotAllowed),
	// 		ViewCharges: to.Ptr(armbilling.ViewChargesPolicyAllowed),
	// 	},
	// }
}

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

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

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

updatePolicy().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

Sample Response

Status code:: 200

{
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/policies/default",
  "name": "default",
  "type": "Microsoft.Billing/billingAccounts/billingProfiles/policies",
  "properties": {
    "marketplacePurchases": "OnlyFreeAllowed",
    "reservationPurchases": "NotAllowed",
    "viewCharges": "Allowed"
  }
}

Definicje

Nazwa	Opis
ErrorDetails	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.
ErrorSubDetails
MarketplacePurchasesPolicy	Zasady, które określają, czy zakupy w witrynie Azure Marketplace są dozwolone dla profilu rozliczeniowego.
Policy	Zasady.
ReservationPurchasesPolicy	Zasady, które określają, czy zakupy rezerwacji platformy Azure są dozwolone dla profilu rozliczeniowego.
ViewChargesPolicy	Zasady, które kontrolują, czy użytkownicy z dostępem RBAC platformy Azure do subskrypcji mogą wyświetlać swoje opłaty.

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	ErrorSubDetails[]	Szczegóły podrzędne błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.
target	string	Element docelowy określonego błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu.

ErrorSubDetails

Nazwa	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.
target	string	Element docelowy określonego błędu.

MarketplacePurchasesPolicy

Zasady, które określają, czy zakupy w witrynie Azure Marketplace są dozwolone dla profilu rozliczeniowego.

Nazwa	Typ	Opis
AllAllowed	string
NotAllowed	string
OnlyFreeAllowed	string

Policy

Zasady.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.marketplacePurchases	MarketplacePurchasesPolicy	Zasady, które określają, czy zakupy w witrynie Azure Marketplace są dozwolone dla profilu rozliczeniowego.
properties.reservationPurchases	ReservationPurchasesPolicy	Zasady, które określają, czy zakupy rezerwacji platformy Azure są dozwolone dla profilu rozliczeniowego.
properties.viewCharges	ViewChargesPolicy	Zasady, które kontrolują, czy użytkownicy z dostępem RBAC platformy Azure do subskrypcji mogą wyświetlać swoje opłaty.
type	string	Typ zasobu.

ReservationPurchasesPolicy

Zasady, które określają, czy zakupy rezerwacji platformy Azure są dozwolone dla profilu rozliczeniowego.

Nazwa	Typ	Opis
Allowed	string
NotAllowed	string

ViewChargesPolicy

Zasady, które kontrolują, czy użytkownicy z dostępem RBAC platformy Azure do subskrypcji mogą wyświetlać swoje opłaty.

Nazwa	Typ	Opis
Allowed	string
NotAllowed	string

Udostępnij za pośrednictwem

Policies - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Scopes

Przykłady

UpdatePolicy

Sample Request

Sample Response

Definicje

ErrorDetails

ErrorResponse

ErrorSubDetails

MarketplacePurchasesPolicy

Policy

ReservationPurchasesPolicy

ViewChargesPolicy

Dodatkowe zasoby