Atualizar um SelfServePolicyUpdate a SelfServePolicy

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Este tópico explica como atualizar uma política de autoatendimento.This topic explains how to update a self serve policy.

Pré-requisitosPrerequisites

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
PosicionePUT {baseURL}/v1/SelfServePolicy http/1.1{baseURL}/v1/SelfServePolicy HTTP/1.1

Cabeçalhos de solicitaçãoRequest headers

Corpo da solicitaçãoRequest body

Esta tabela descreve as propriedades necessárias no corpo da solicitação.This table describes the required properties in the request body.

NomeName TypeType DescriptionDescription
SelfServePolicySelfServePolicy objetoobject As informações de política de autoatendimento.The self serve policy information.

SelfServePolicySelfServePolicy

Esta tabela descreve os campos mínimos necessários do recurso SelfServePolicy necessário para criar uma nova política de autoatendimento.This table describes the minimum required fields from the SelfServePolicy resource needed to create a new self serve policy.

PropriedadeProperty TipoType DescriçãoDescription
idid stringstring Um identificador de política de autoatendimento que é fornecido após a criação bem-sucedida da política de autoatendimento.A self serve policy identifier that is supplied upon successful creation of the self serve policy.
SelfServeEntitySelfServeEntity SelfServeEntitySelfServeEntity A entidade de autoatendimento que está recebendo acesso.The self serve entity that is being granted access.
ConcessorGrantor ConcessorGrantor O concessor que está concedendo acesso.The grantor that is granting access.
PermissõesPermissions Matriz de permissãoArray of Permission Uma matriz de recursos de permissão .An Array of Permission resources.
EtagEtag stringstring A ETag.The Etag.

Exemplo de solicitaçãoRequest example

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"
    }],
    "attributes": {
        "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
        "objectType": "SelfServePolicy"
    }
}

Resposta RESTREST response

Se for bem-sucedida, essa API retornará um recurso SelfServePolicy para a política de autoatendimento atualizada.If successful, this API returns a SelfServePolicy resource for the updated self serve policy.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Esse método retorna os seguintes códigos de erro:This method returns the following error codes:

Código de status HTTPHTTP Status Code Código do erroError code DescriçãoDescription
404404 600039600039 A política de autoatendimento não foi encontradaSelf serve policy was not found
404404 600040600040 O identificador de política de autoatendimento está incorretoSelf serve policy identifier is incorrect

Exemplo de respostaResponse example

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"
    }],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}