Actualizar selfServePolicy
En este artículo se explica cómo actualizar una directiva de autoservicio.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación y usuario.
C#
Para actualizar una directiva de autoservicio:
Llame al método IAggregatePartner.SelfServePolicies.ById con el identificador de entidad para recuperar una interfaz a las operaciones en las directivas.
Llame al método Put o PutAsync para actualizar la directiva de autoservicio.
// 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);
Solicitud REST
Sintaxis de la solicitud
Método | URI de solicitud |
---|---|
PUT | {baseURL}/v1/SelfServePolicy HTTP/1.1 |
Encabezados de solicitud
- Se requiere un identificador de solicitud y un identificador de correlación.
- Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
En esta tabla se describen las propiedades necesarias en el cuerpo de la solicitud.
Nombre | Tipo | Descripción |
---|---|---|
SelfServePolicy | object | Información de la directiva de autoservicio. |
SelfServePolicy
En esta tabla se describen los campos mínimos necesarios del recurso SelfServePolicy necesario para crear una nueva directiva de autoservicio.
Propiedad | Tipo | Descripción |
---|---|---|
id | string | Identificador de directiva de autoservicio que se proporciona tras la creación correcta de la directiva de autoservicio. |
SelfServeEntity | SelfServeEntity | Entidad de autoservicio a la que se concede acceso. |
Otorgante de permisos | Otorgante de permisos | Receptor al que se concede acceso. |
Permisos | Matriz de permisos | Matriz de recursos de permiso . |
Etag | string | The Etag. |
Ejemplo de solicitud
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"
}
}
Respuesta REST
Si se ejecuta correctamente, esta API devuelve un recurso SelfServePolicy para la directiva de autoservicio actualizada.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.
Este método devuelve los siguientes códigos de error:
Código de estado HTTP | Código de error | Descripción |
---|---|---|
404 | 600039 | No se encontró la directiva de autoservicio |
404 | 600040 | El identificador de directiva de autoservicio es incorrecto |
Ejemplo de respuesta
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"
}
}
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de