Services - Create Or Update

Riferimento

Servizio:: Mobile Network

Versione API:: 2024-04-01

Crea o aggiorna un servizio. Deve essere creato nella stessa posizione della rete mobile padre.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
mobileNetworkName	path	True	string	Nome della rete mobile. Criterio di espressione regolare: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
resourceGroupName	path	True	string	Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
serviceName	path	True	string	Il nome del servizio. Non è necessario usare una delle stringhe riservate seguenti : `default`o `requestedservice` Criterio di espressione regolare: `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$`
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.pccRules	True	PccRuleConfiguration[]	Set di regole dei criteri del flusso di dati che costituiscono questo servizio.
properties.servicePrecedence	True	integer	Valore di precedenza usato per decidere tra i servizi quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutti i servizi configurati nella rete mobile.
properties.serviceQosPolicy		QosPolicy	Criteri QoS da usare per i pacchetti corrispondenti a questo servizio. Può essere sottoposto a override per flussi specifici usando il campo ruleQosPolicy in un PccRuleConfiguration. Se questo campo è Null, il criterio SIM ue definirà le impostazioni QoS.
tags		object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	Service	Aggiornamento riuscito. L'operazione restituisce la risorsa del servizio risultante.
201 Created	Service	Create esito positivo. L'operazione restituisce la risorsa del servizio risultante.
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Create service

Esempio di richiesta

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": []
          }
        ]
      }
    ]
  }
}


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

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

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

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

Risposta di esempio

Codice di stato:: 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": []
          }
        ]
      }
    ]
  }
}

Codice di stato:: 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": []
          }
        ]
      }
    ]
  }
}

Definizioni

Nome	Descrizione
Ambr	Velocità massima di bit aggregata.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PccRuleConfiguration	Configurazione delle regole dei criteri del flusso di dati
PccRuleQosPolicy	Criterio QoS dei criteri del flusso di dati
PreemptionCapability	Funzionalità di precedenza.
PreemptionVulnerability	Vulnerabilità di precedenza.
ProvisioningState	Stato di provisioning corrente.
QosPolicy	Criterio QoS
SdfDirection	Direzione del flusso di dati del servizio.
Service	Risorsa del servizio. Deve essere creato nella stessa posizione della rete mobile padre.
ServiceDataFlowTemplate	Modello flusso di dati
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TrafficControlPermission	Autorizzazione di controllo del traffico.

Ambr

Velocità massima di bit aggregata.

Nome	Tipo	Descrizione
downlink	string	Velocità di bit downlink.
uplink	string	Velocità dei bit uplink.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PccRuleConfiguration

Configurazione delle regole dei criteri del flusso di dati

Nome	Tipo	Valore predefinito	Descrizione
ruleName	string		Nome della regola. Deve essere univoco all'interno del servizio padre. Non è necessario usare una delle stringhe riservate seguenti: `default`o `requestedservice`.
rulePrecedence	integer		Valore di precedenza usato per decidere tra le regole dei criteri del flusso di dati quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutte le regole dei criteri del flusso di dati configurate nella rete mobile.
ruleQosPolicy	PccRuleQosPolicy		Criterio QoS da usare per i pacchetti corrispondenti a questa regola. Se questo campo è Null, il servizio padre definirà le impostazioni QoS.
serviceDataFlowTemplates	ServiceDataFlowTemplate[]		Set di modelli di flusso di dati da usare per questa regola dei criteri del flusso di dati.
trafficControl	TrafficControlPermission	Enabled	Determina se i flussi che corrispondono a questa regola dei criteri del flusso di dati sono consentiti.

PccRuleQosPolicy

Criterio QoS dei criteri del flusso di dati

Nome	Tipo	Valore predefinito	Descrizione
5qi	integer	9	Valore dell'indicatore di flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere 3GPP TS23.501 sezione 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.
allocationAndRetentionPriorityLevel	integer	9	Livello di allocazione del flusso QoS e priorità di conservazione .QoS Flow allocation and retention priority (ARP). I flussi con priorità più alta preempt passano con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` lo consentono. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.
guaranteedBitRate	Ambr		Velocità in bit garantita (GBR) per tutti i flussi di dati del servizio che usano questa regola dei criteri del flusso di dati. Si tratta di un'impostazione facoltativa. Se non si specifica un valore, non sarà impostato alcun GBR per la regola dei criteri del flusso di dati che usa questa definizione QoS.
maximumBitRate	Ambr		Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.
preemptionCapability	PreemptionCapability	NotPreempt	Funzionalità di precedenza del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.

PreemptionCapability

Funzionalità di precedenza.

Nome	Tipo	Descrizione
MayPreempt	string	Può precedere
NotPreempt	string	Impossibile anteporre il preempt

PreemptionVulnerability

Vulnerabilità di precedenza.

Nome	Tipo	Descrizione
NotPreemptable	string	Non può essere superato
Preemptable	string	Può essere preempted

ProvisioningState

Stato di provisioning corrente.

Nome	Tipo	Descrizione
Accepted	string
Canceled	string
Deleted	string
Deleting	string
Failed	string
Succeeded	string
Unknown	string

QosPolicy

Criterio QoS

Nome	Tipo	Valore predefinito	Descrizione
5qi	integer	9	Valore dell'indicatore di flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere 3GPP TS23.501 sezione 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.
allocationAndRetentionPriorityLevel	integer	9	Livello di allocazione del flusso QoS e priorità di conservazione .QoS Flow allocation and retention priority (ARP). I flussi con priorità più alta preempt passano con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` lo consentono. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.
maximumBitRate	Ambr		Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.
preemptionCapability	PreemptionCapability	NotPreempt	Funzionalità di precedenza del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere la sezione 3GPP TS23.501 sezione 5.7.2.2.

SdfDirection

Direzione del flusso di dati del servizio.

Nome	Tipo	Descrizione
Bidirectional	string	Flusso del traffico sia da che verso l'UE.
Downlink	string	Flusso del traffico dalla rete dati all'UE.
Uplink	string	Flusso del traffico dall'UE alla rete dati.

Service

Risorsa del servizio. Deve essere creato nella stessa posizione della rete mobile padre.

Nome	Tipo	Descrizione
id	string	ID di risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.pccRules	PccRuleConfiguration[]	Set di regole dei criteri del flusso di dati che costituiscono questo servizio.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa del servizio.
properties.servicePrecedence	integer	Valore di precedenza usato per decidere tra i servizi quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutti i servizi configurati nella rete mobile.
properties.serviceQosPolicy	QosPolicy	Criteri QoS da usare per i pacchetti corrispondenti a questo servizio. Può essere sottoposto a override per flussi specifici usando il campo ruleQosPolicy in un PccRuleConfiguration. Se questo campo è Null, il criterio SIM ue definirà le impostazioni QoS.
systemData	systemData	Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Modello flusso di dati

Nome	Tipo	Descrizione
direction	SdfDirection	Direzione di questo flusso.
ports	string[]	Porte a cui si connetteranno le ENTITÀ per questo flusso. È possibile specificare zero o più porte o intervalli di porte. Se si specificano una o più porte o intervalli di porte, è necessario specificare un valore diverso `ip` da nel `protocol` campo . Si tratta di un'impostazione facoltativa. Se non lo si specifica, le connessioni saranno consentite su tutte le porte. Gli intervalli di porte devono essere specificati come -. Ad esempio: [`8080`, `8082-8085`].
protocol	string[]	Elenco dei protocolli consentiti per questo flusso. Se si vuole che questo flusso sia in grado di usare qualsiasi protocollo all'interno della suite di protocolli Internet, usare il valore `ip`. Se si vuole consentire solo una selezione di protocolli, è necessario usare il numero di protocollo Internet assegnato IANA corrispondente per ogni protocollo, come descritto in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Ad esempio, per UDP, è necessario usare 17. Se si usa il valore `ip` , è necessario lasciare il campo `port` non specificato.
remoteIpList	string[]	Indirizzo IP remoto a cui si connetteranno le ENTITÀ per questo flusso. Se si desidera consentire le connessioni in qualsiasi indirizzo IP, usare il valore `any`. In caso contrario, è necessario specificare ognuno degli indirizzi IP remoti a cui si connetterà l'istanza di base del pacchetto per questo flusso. È necessario specificare ogni indirizzo IP nella notazione CIDR, inclusa la maschera di rete ,ad esempio 192.0.2.54/24.
templateName	string	Nome del modello del flusso di dati. Deve essere univoco all'interno della regola dei criteri del flusso di dati padre. Non è necessario usare una delle stringhe riservate seguenti: `default`o `requestedservice`.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione di risorse (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

TrafficControlPermission

Autorizzazione di controllo del traffico.

Nome	Tipo	Descrizione
Blocked	string	Il flusso del traffico corrispondente a questa regola non è consentito.
Enabled	string	Il flusso del traffico corrispondente a questa regola è consentito.

Condividi tramite

Services - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create service

Esempio di richiesta

Risposta di esempio

Definizioni

Ambr

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PccRuleConfiguration

PccRuleQosPolicy

PreemptionCapability

PreemptionVulnerability

ProvisioningState

QosPolicy

SdfDirection

Service

ServiceDataFlowTemplate

systemData

TrafficControlPermission

Risorse aggiuntive