Atualizar um SelfServePolicy

Artigo
03/19/2024

Este artigo explica como atualizar uma política de autoatendimento.

Pré-requisitos

Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais do Application+User.

C#

Para atualizar uma política de autoatendimento:

Chame o método IAggregatePartner.SelfServePolicies.ById com o identificador de entidade para recuperar uma interface para operações nas políticas.
Chame o método Put ou PutAsync para atualizar a política de autoatendimento.

// IAggregatePartner partnerOperations;
SelfServePolicy policy;

// All the operations executed on this partner operation instance will share the same correlation identifier but will differ in request identifier
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

// updates the self-serve policies
partnerOperations.SelfServePolicies.ById(policy.id).Put(policy);

Solicitação REST

Sintaxe da solicitação

Método	URI da solicitação
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

Cabeçalhos da solicitação

Um identificador de solicitação e um identificador de correlação são necessários.
Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Esta tabela descreve as propriedades necessárias no corpo da solicitação.

Nome	Type	Descrição
SelfServePolicy	objeto	As informações de política de autoatendimento.

SelfServePolicy

Esta tabela descreve os campos mínimos necessários do recurso SelfServePolicy necessários para criar uma nova política de autoatendimento.

Propriedade	Type	Descrição
id	string	Um identificador de política de autoatendimento fornecido após a criação bem-sucedida da política de autoatendimento.
SelfServeEntity	SelfServeEntity	A entidade de autoatendimento que está recebendo acesso.
Concessor	Concessor	O autorizador que está concedendo acesso.
Permissões	Matriz de Permission	Uma matriz de recursos de permissão .
Etag	string	O Etag.

Exemplo de solicitação

PUT https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

{
    "id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
    "selfServeEntity": {
        "selfServeEntityType": "customer",
        "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [
        {
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
        "objectType": "SelfServePolicy"
    }
}

Resposta REST

Se tiver êxito, essa API retornará um recurso SelfServePolicy para a política de autoatendimento atualizada.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Esse método retorna os seguintes códigos de erro:

Código de status HTTP	Código do erro	Descrição
404	600039	A política de autoatendimento não foi encontrada
404	600040	O identificador de política de autoatendimento está incorreto

Exemplo de resposta

HTTP/1.1 200 Ok
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
    "selfServeEntity": {
        "selfServeEntityType": "customer",
        "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [
        {
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}

Share via