Обновление SelfServePolicy

Статья
03/19/2024

В этой статье объясняется, как обновить политику самообслуживания.

Предварительные условия

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с использованием учетных данных приложения и пользователя.

C#

Чтобы обновить политику самообслуживания, выполните следующие действия.

Вызовите метод IAggregatePartner.SelfServePolicies.ById с идентификатором сущности, чтобы получить интерфейс для операций с политиками.
Вызовите метод Put или PutAsync , чтобы обновить политику самообслуживания.

// 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);

Запрос REST

Синтаксис запроса

Метод	Универсальный код ресурса (URI) запроса
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

Заголовки запросов

Требуются идентификатор запроса и идентификатор корреляции.
Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Тело запроса

В этой таблице описываются обязательные свойства в тексте запроса.

Имя	Тип	Описание
SelfServePolicy	object	Сведения о политике самообслуживания.

SelfServePolicy

В этой таблице описываются минимальные обязательные поля из ресурса SelfServePolicy , необходимые для создания новой политики самообслуживания.

Свойство	Тип	Описание
идентификатор	строка	Идентификатор политики самообслуживания, который предоставляется после успешного создания политики самообслуживания.
SelfServeEntity	SelfServeEntity	Сущность самообслуживания, которой предоставляется доступ.
Grantor	Grantor	Участник, предоставляющий доступ.
Разрешения	Массив элементов Permission	Массив ресурсов разрешений .
Etag	строка	The Etag.

Пример запроса

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"
    }
}

Ответ REST

В случае успешного выполнения этот API возвращает ресурс SelfServePolicy для обновленной политики самообслуживания.

Коды успешного выполнения и ошибок в ответе

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.

Этот метод возвращает следующие коды ошибок:

Код состояния HTTP	Код ошибки	Описание
404	600039	Политика самообслуживания не найдена
404	600040	Неправильный идентификатор политики самообслуживания

Пример ответа

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