Services - Create Or Update

Servicio:

Mobile Network

Versión de la API:

2024-04-01

Crea o actualiza un servicio. Debe crearse en la misma ubicación que su red móvil primaria.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
mobileNetworkName	path	True	string maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$	Nombre de la red móvil.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
serviceName	path	True	string maxLength: 64 pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$	Nombre del servicio. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
properties.pccRules	True	PccRuleConfiguration[]	Conjunto de reglas de directiva de flujo de datos que componen este servicio.
properties.servicePrecedence	True	integer (int32) minimum: 0 maximum: 255	Valor de precedencia que se usa para decidir entre servicios al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor inferior significa una prioridad más alta. Este valor debe ser único entre todos los servicios configurados en la red móvil.
properties.serviceQosPolicy		QosPolicy	La directiva QoS que se va a usar para los paquetes que coinciden con este servicio. Esto se puede invalidar para flujos concretos mediante el campo ruleQosPolicy en un PccRuleConfiguration. Si este campo es null, la directiva SIM de la UE definirá la configuración de QoS.
tags		object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	Service	Se ha actualizado correctamente. La operación devuelve el recurso de servicio resultante.
201 Created	Service	Cree correctamente. La operación devuelve el recurso de servicio resultante.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Create service

Solicitud de ejemplo

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Java

import com.azure.resourcemanager.mobilenetwork.models.Ambr;
import com.azure.resourcemanager.mobilenetwork.models.PccRuleConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.PccRuleQosPolicy;
import com.azure.resourcemanager.mobilenetwork.models.PreemptionCapability;
import com.azure.resourcemanager.mobilenetwork.models.PreemptionVulnerability;
import com.azure.resourcemanager.mobilenetwork.models.QosPolicy;
import com.azure.resourcemanager.mobilenetwork.models.SdfDirection;
import com.azure.resourcemanager.mobilenetwork.models.ServiceDataFlowTemplate;
import com.azure.resourcemanager.mobilenetwork.models.TrafficControlPermission;
import java.util.Arrays;

/**
 * Samples for Services CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.
     * json
     */
    /**
     * Sample code: Create service.
     * 
     * @param manager Entry point to MobileNetworkManager.
     */
    public static void createService(com.azure.resourcemanager.mobilenetwork.MobileNetworkManager manager) {
        manager.services().define("TestService").withRegion("eastus")
            .withExistingMobileNetwork("rg1", "testMobileNetwork").withServicePrecedence(255)
            .withPccRules(Arrays.asList(new PccRuleConfiguration().withRuleName("default-rule").withRulePrecedence(255)
                .withRuleQosPolicy(new PccRuleQosPolicy().withFiveQi(9).withAllocationAndRetentionPriorityLevel(9)
                    .withPreemptionCapability(PreemptionCapability.NOT_PREEMPT)
                    .withPreemptionVulnerability(PreemptionVulnerability.PREEMPTABLE)
                    .withMaximumBitRate(new Ambr().withUplink("500 Mbps").withDownlink("1 Gbps")))
                .withTrafficControl(TrafficControlPermission.ENABLED).withServiceDataFlowTemplates(
                    Arrays.asList(new ServiceDataFlowTemplate().withTemplateName("IP-to-server")
                        .withDirection(SdfDirection.UPLINK).withProtocol(Arrays.asList("ip"))
                        .withRemoteIpList(Arrays.asList("10.3.4.0/24")).withPorts(Arrays.asList())))))
            .withServiceQosPolicy(new QosPolicy().withFiveQi(9).withAllocationAndRetentionPriorityLevel(9)
                .withPreemptionCapability(PreemptionCapability.NOT_PREEMPT)
                .withPreemptionVulnerability(PreemptionVulnerability.PREEMPTABLE)
                .withMaximumBitRate(new Ambr().withUplink("500 Mbps").withDownlink("1 Gbps")))
            .create();
    }
}

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

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.mobilenetwork import MobileNetworkManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-mobilenetwork
# USAGE
    python service_create.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 = MobileNetworkManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.services.begin_create_or_update(
        resource_group_name="rg1",
        mobile_network_name="testMobileNetwork",
        service_name="TestService",
        parameters={
            "location": "eastus",
            "properties": {
                "pccRules": [
                    {
                        "ruleName": "default-rule",
                        "rulePrecedence": 255,
                        "ruleQosPolicy": {
                            "5qi": 9,
                            "allocationAndRetentionPriorityLevel": 9,
                            "maximumBitRate": {"downlink": "1 Gbps", "uplink": "500 Mbps"},
                            "preemptionCapability": "NotPreempt",
                            "preemptionVulnerability": "Preemptable",
                        },
                        "serviceDataFlowTemplates": [
                            {
                                "direction": "Uplink",
                                "ports": [],
                                "protocol": ["ip"],
                                "remoteIpList": ["10.3.4.0/24"],
                                "templateName": "IP-to-server",
                            }
                        ],
                        "trafficControl": "Enabled",
                    }
                ],
                "servicePrecedence": 255,
                "serviceQosPolicy": {
                    "5qi": 9,
                    "allocationAndRetentionPriorityLevel": 9,
                    "maximumBitRate": {"downlink": "1 Gbps", "uplink": "500 Mbps"},
                    "preemptionCapability": "NotPreempt",
                    "preemptionVulnerability": "Preemptable",
                },
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.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

Go

package armmobilenetwork_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/mobilenetwork/armmobilenetwork/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d88c94b22a8efdd47c0cadfe6d8d489107db2b23/specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.json
func ExampleServicesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmobilenetwork.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewServicesClient().BeginCreateOrUpdate(ctx, "rg1", "testMobileNetwork", "TestService", armmobilenetwork.Service{
		Location: to.Ptr("eastus"),
		Properties: &armmobilenetwork.ServicePropertiesFormat{
			PccRules: []*armmobilenetwork.PccRuleConfiguration{
				{
					RuleName:       to.Ptr("default-rule"),
					RulePrecedence: to.Ptr[int32](255),
					RuleQosPolicy: &armmobilenetwork.PccRuleQosPolicy{
						FiveQi:                              to.Ptr[int32](9),
						AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
						MaximumBitRate: &armmobilenetwork.Ambr{
							Downlink: to.Ptr("1 Gbps"),
							Uplink:   to.Ptr("500 Mbps"),
						},
						PreemptionCapability:    to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
						PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
					},
					ServiceDataFlowTemplates: []*armmobilenetwork.ServiceDataFlowTemplate{
						{
							Direction: to.Ptr(armmobilenetwork.SdfDirectionUplink),
							Ports:     []*string{},
							RemoteIPList: []*string{
								to.Ptr("10.3.4.0/24")},
							TemplateName: to.Ptr("IP-to-server"),
							Protocol: []*string{
								to.Ptr("ip")},
						}},
					TrafficControl: to.Ptr(armmobilenetwork.TrafficControlPermissionEnabled),
				}},
			ServicePrecedence: to.Ptr[int32](255),
			ServiceQosPolicy: &armmobilenetwork.QosPolicy{
				FiveQi:                              to.Ptr[int32](9),
				AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
				MaximumBitRate: &armmobilenetwork.Ambr{
					Downlink: to.Ptr("1 Gbps"),
					Uplink:   to.Ptr("500 Mbps"),
				},
				PreemptionCapability:    to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
				PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %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.Service = armmobilenetwork.Service{
	// 	Name: to.Ptr("testPolicy"),
	// 	Type: to.Ptr("Microsoft.MobileNetwork/service"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService"),
	// 	SystemData: &armmobilenetwork.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-01T17:18:19.123Z"); return t}()),
	// 		CreatedBy: to.Ptr("user1"),
	// 		CreatedByType: to.Ptr(armmobilenetwork.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-02T17:18:19.123Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("user2"),
	// 		LastModifiedByType: to.Ptr(armmobilenetwork.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("eastus"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armmobilenetwork.ServicePropertiesFormat{
	// 		PccRules: []*armmobilenetwork.PccRuleConfiguration{
	// 			{
	// 				RuleName: to.Ptr("default-rule"),
	// 				RulePrecedence: to.Ptr[int32](255),
	// 				RuleQosPolicy: &armmobilenetwork.PccRuleQosPolicy{
	// 					FiveQi: to.Ptr[int32](9),
	// 					AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
	// 					MaximumBitRate: &armmobilenetwork.Ambr{
	// 						Downlink: to.Ptr("1 Gbps"),
	// 						Uplink: to.Ptr("500 Mbps"),
	// 					},
	// 					PreemptionCapability: to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
	// 					PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
	// 				},
	// 				ServiceDataFlowTemplates: []*armmobilenetwork.ServiceDataFlowTemplate{
	// 					{
	// 						Direction: to.Ptr(armmobilenetwork.SdfDirectionUplink),
	// 						Ports: []*string{
	// 						},
	// 						RemoteIPList: []*string{
	// 							to.Ptr("10.3.4.0/24")},
	// 							TemplateName: to.Ptr("IP-to-server"),
	// 							Protocol: []*string{
	// 								to.Ptr("ip")},
	// 						}},
	// 						TrafficControl: to.Ptr(armmobilenetwork.TrafficControlPermissionEnabled),
	// 				}},
	// 				ProvisioningState: to.Ptr(armmobilenetwork.ProvisioningStateSucceeded),
	// 				ServicePrecedence: to.Ptr[int32](255),
	// 				ServiceQosPolicy: &armmobilenetwork.QosPolicy{
	// 					FiveQi: to.Ptr[int32](9),
	// 					AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
	// 					MaximumBitRate: &armmobilenetwork.Ambr{
	// 						Downlink: to.Ptr("1 Gbps"),
	// 						Uplink: to.Ptr("500 Mbps"),
	// 					},
	// 					PreemptionCapability: to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
	// 					PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
	// 				},
	// 			},
	// 		}
}

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

JavaScript

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

/**
 * This sample demonstrates how to Creates or updates a service. Must be created in the same location as its parent mobile network.
 *
 * @summary Creates or updates a service. Must be created in the same location as its parent mobile network.
 * x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.json
 */
async function createService() {
  const subscriptionId =
    process.env["MOBILENETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MOBILENETWORK_RESOURCE_GROUP"] || "rg1";
  const mobileNetworkName = "testMobileNetwork";
  const serviceName = "TestService";
  const parameters = {
    location: "eastus",
    pccRules: [
      {
        ruleName: "default-rule",
        rulePrecedence: 255,
        ruleQosPolicy: {
          fiveQi: 9,
          allocationAndRetentionPriorityLevel: 9,
          maximumBitRate: { downlink: "1 Gbps", uplink: "500 Mbps" },
          preemptionCapability: "NotPreempt",
          preemptionVulnerability: "Preemptable",
        },
        serviceDataFlowTemplates: [
          {
            direction: "Uplink",
            ports: [],
            remoteIpList: ["10.3.4.0/24"],
            templateName: "IP-to-server",
            protocol: ["ip"],
          },
        ],
        trafficControl: "Enabled",
      },
    ],
    servicePrecedence: 255,
    serviceQosPolicy: {
      fiveQi: 9,
      allocationAndRetentionPriorityLevel: 9,
      maximumBitRate: { downlink: "1 Gbps", uplink: "500 Mbps" },
      preemptionCapability: "NotPreempt",
      preemptionVulnerability: "Preemptable",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new MobileNetworkManagementClient(credential, subscriptionId);
  const result = await client.services.beginCreateOrUpdateAndWait(
    resourceGroupName,
    mobileNetworkName,
    serviceName,
    parameters,
  );
  console.log(result);
}

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

Respuesta de muestra

status code:

200

{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Succeeded",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

status code:

201

Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01

{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Created",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Definiciones

Nombre	Description
Ambr	Velocidad máxima de bits agregada.
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
PccRuleConfiguration	Configuración de reglas de directiva de flujo de datos
PccRuleQosPolicy	Directiva de QoS de la regla de flujo de datos
PreemptionCapability	Capacidad de adelantamiento.
PreemptionVulnerability	Vulnerabilidad de adelantamiento.
ProvisioningState	Estado de aprovisionamiento actual.
QosPolicy	Directiva de QoS
SdfDirection	Dirección del flujo de datos del servicio.
Service	Recurso de servicio. Debe crearse en la misma ubicación que su red móvil primaria.
ServiceDataFlowTemplate	Plantilla de flujo de datos
systemData	Metadatos relativos a la creación y última modificación del recurso.
TrafficControlPermission	Permiso de control de tráfico.

Ambr

Object

Velocidad máxima de bits agregada.

Nombre	Tipo	Description
downlink	string pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$	Velocidad de bits de vínculo descendente.
uplink	string pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$	Velocidad de bits de vínculo superior.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

PccRuleConfiguration

Object

Configuración de reglas de directiva de flujo de datos

Nombre	Tipo	Valor predeterminado	Description
ruleName	string maxLength: 64 pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$		Nombre de la regla. Debe ser único dentro del servicio primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service.
rulePrecedence	integer (int32) minimum: 0 maximum: 255		Valor de precedencia que se usa para decidir entre reglas de directiva de flujo de datos al identificar los valores de QoS que se usarán para una SIM determinada. Un valor inferior significa una prioridad más alta. Este valor debe ser único entre todas las reglas de directiva de flujo de datos configuradas en la red móvil.
ruleQosPolicy	PccRuleQosPolicy		La directiva QoS que se va a usar para los paquetes que coinciden con esta regla. Si este campo es null, el servicio primario definirá la configuración de QoS.
serviceDataFlowTemplates	ServiceDataFlowTemplate[]		Conjunto de plantillas de flujo de datos que se van a usar para esta regla de directiva de flujo de datos.
trafficControl	TrafficControlPermission	Enabled	Determina si se permiten flujos que coincidan con esta regla de directiva de flujo de datos.

PccRuleQosPolicy

Object

Directiva de QoS de la regla de flujo de datos

Nombre	Tipo	Valor predeterminado	Description
5qi	integer (int32) minimum: 1 maximum: 127	9	Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento específico de reenvío de QoS que se va a proporcionar a un flujo. Consulte la sección 5.7.7.2.1 de 3GPP TS23.501 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI.
allocationAndRetentionPriorityLevel	integer (int32) minimum: 1 maximum: 15	9	Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con una prioridad mayor que los flujos con prioridad más baja, si la configuración de preemptionCapability y preemptionVulnerability permitirlo. 1 es el nivel de prioridad más alto. Si no se especifica este campo, se usa 5qi para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.
guaranteedBitRate	Ambr		Velocidad de bits garantizada (GBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos. Se trata de una configuración opcional. Si no proporciona un valor, no habrá ningún conjunto de GBR para la regla de directiva de flujo de datos que use esta definición de QoS.
maximumBitRate	Ambr		Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla o servicio de directiva de flujo de datos.
preemptionCapability	PreemptionCapability	NotPreempt	Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede reemplazar otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.

PreemptionCapability

Enumeración

Capacidad de adelantamiento.

Valor	Description
MayPreempt	Adelantamiento de mayo
NotPreempt	No se puede preempt

PreemptionVulnerability

Enumeración

Vulnerabilidad de adelantamiento.

Valor	Description
NotPreemptable	No se puede adelantamiento
Preemptable	Se puede adelantamiento

ProvisioningState

Enumeración

Estado de aprovisionamiento actual.

Valor	Description
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

QosPolicy

Object

Directiva de QoS

Nombre	Tipo	Valor predeterminado	Description
5qi	integer (int32) minimum: 1 maximum: 127	9	Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento específico de reenvío de QoS que se va a proporcionar a un flujo. Consulte la sección 5.7.7.2.1 de 3GPP TS23.501 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI.
allocationAndRetentionPriorityLevel	integer (int32) minimum: 1 maximum: 15	9	Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con una prioridad mayor que los flujos con prioridad más baja, si la configuración de preemptionCapability y preemptionVulnerability permitirlo. 1 es el nivel de prioridad más alto. Si no se especifica este campo, se usa 5qi para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.
maximumBitRate	Ambr		Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla o servicio de directiva de flujo de datos.
preemptionCapability	PreemptionCapability	NotPreempt	Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede reemplazar otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP.

SdfDirection

Enumeración

Dirección del flujo de datos del servicio.

Valor	Description
Bidirectional	Tráfico que fluye hacia y desde la UE.
Downlink	Tráfico que fluye desde la red de datos a la UE.
Uplink	Tráfico que fluye desde la UE a la red de datos.

Service

Object

Recurso de servicio. Debe crearse en la misma ubicación que su red móvil primaria.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties.pccRules	PccRuleConfiguration[]	Conjunto de reglas de directiva de flujo de datos que componen este servicio.
properties.provisioningState	ProvisioningState	Estado de aprovisionamiento del recurso de servicio.
properties.servicePrecedence	integer (int32) minimum: 0 maximum: 255	Valor de precedencia que se usa para decidir entre servicios al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor inferior significa una prioridad más alta. Este valor debe ser único entre todos los servicios configurados en la red móvil.
properties.serviceQosPolicy	QosPolicy	La directiva QoS que se va a usar para los paquetes que coinciden con este servicio. Esto se puede invalidar para flujos concretos mediante el campo ruleQosPolicy en un PccRuleConfiguration. Si este campo es null, la directiva SIM de la UE definirá la configuración de QoS.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Object

Plantilla de flujo de datos

Nombre	Tipo	Description
direction	SdfDirection	Dirección de este flujo.
ports	string[] pattern: ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$	Los puertos a los que se conectarán los UE para este flujo. Puede especificar cero o más puertos o intervalos de puertos. Si especifica uno o varios puertos o intervalos de puertos, debe especificar un valor distinto de ip en el campo protocol. Se trata de una configuración opcional. Si no lo especifica, se permitirán las conexiones en todos los puertos. Los intervalos de puertos deben especificarse como -. Por ejemplo: [8080, 8082-8085].
protocol	string[] pattern: ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$	Lista de los protocolos permitidos para este flujo. Si desea que este flujo pueda usar cualquier protocolo dentro del conjunto de protocolos de Internet, use el valor ip. Si solo desea permitir una selección de protocolos, debe usar el número de protocolo de Internet asignado de IANA correspondiente para cada protocolo, como se describe en https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por ejemplo, para UDP, debe usar 17. Si usa el valor ip, debe dejar el campo port no especificado.
remoteIpList	string[] pattern: ^(any|(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2])))$	Las direcciones IP remotas a las que se conectarán los UE para este flujo. Si desea permitir conexiones en cualquier dirección IP, use el valor any. De lo contrario, debe proporcionar cada una de las direcciones IP remotas a las que se conectará la instancia de núcleo del paquete para este flujo. Debe proporcionar cada dirección IP en notación CIDR, incluida la máscara de red (por ejemplo, 192.0.2.54/24).
templateName	string maxLength: 64 pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$	Nombre de la plantilla de flujo de datos. Debe ser único dentro de la regla de directiva de flujo de datos principal. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

TrafficControlPermission

Enumeración

Permiso de control de tráfico.

Valor	Description
Blocked	No se permite que el tráfico coincida con esta regla.
Enabled	El tráfico que coincide con esta regla puede fluir.