Services - Create Or Update

Usługa:

Mobile Network

Wersja interfejsu API:

2024-04-01

Tworzy lub aktualizuje usługę. Należy utworzyć w tej samej lokalizacji co nadrzędna sieć mobilna.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
mobileNetworkName	path	True	string	Nazwa sieci komórkowej. Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
serviceName	path	True	string	Nazwa usługi. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service Wzorzec wyrażenia regularnego: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId	path	True	string uuid	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.pccRules	True	PccRuleConfiguration[]	Zestaw reguł zasad przepływu danych, które tworzą tę usługę.
properties.servicePrecedence	True	integer	Wartość pierwszeństwa używana do określania między usługami podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich usług skonfigurowanych w sieci komórkowej.
properties.serviceQosPolicy		QosPolicy	Zasady QoS do użycia dla pakietów pasujących do tej usługi. Można to przesłonić dla określonych przepływów przy użyciu pola ruleQosPolicy w pccRuleConfiguration. Jeśli to pole ma wartość null, zasady SIM ue zdefiniują ustawienia QoS.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Service	Aktualizacja powiodła się. Operacja zwraca wynikowy zasób usługi.
201 Created	Service	Twórca pomyślne. Operacja zwraca wynikowy zasób usługi.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create service

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

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

Definicje

Nazwa	Opis
Ambr	Agregacja maksymalnej szybkości bitów.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
PccRuleConfiguration	Konfiguracja reguły zasad przepływu danych
PccRuleQosPolicy	Zasady QoS reguły przepływu danych
PreemptionCapability	Możliwość wywłaszczania.
PreemptionVulnerability	Luka w zabezpieczeniach dotycząca wywłaszczania.
ProvisioningState	Bieżący stan aprowizacji.
QosPolicy	Zasady QoS
SdfDirection	Kierunek przepływu danych usługi.
Service	Zasób usługi. Należy utworzyć w tej samej lokalizacji co nadrzędna sieć mobilna.
ServiceDataFlowTemplate	Szablon przepływu danych
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TrafficControlPermission	Uprawnienia do sterowania ruchem.

Ambr

Agregacja maksymalnej szybkości bitów.

Nazwa	Typ	Opis
downlink	string	Szybkość bitów pasma.
uplink	string	Szybkość połączenia bitowego.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

PccRuleConfiguration

Konfiguracja reguły zasad przepływu danych

Nazwa	Typ	Domyślna wartość	Opis
ruleName	string		Nazwa reguły. Musi to być unikatowe w ramach usługi nadrzędnej. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service.
rulePrecedence	integer		Wartość pierwszeństwa używana do decydowania między regułami zasad przepływu danych podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich reguł zasad przepływu danych skonfigurowanych w sieci komórkowej.
ruleQosPolicy	PccRuleQosPolicy		Zasady QoS do użycia dla pakietów pasujących do tej reguły. Jeśli to pole ma wartość null, usługa nadrzędna zdefiniuje ustawienia QoS.
serviceDataFlowTemplates	ServiceDataFlowTemplate[]		Zestaw szablonów przepływu danych do użycia dla tej reguły zasad przepływu danych.
trafficControl	TrafficControlPermission	Enabled	Określa, czy przepływy zgodne z tą regułą zasad przepływu danych są dozwolone.

PccRuleQosPolicy

Zasady QoS reguły przepływu danych

Nazwa	Typ	Domyślna wartość	Opis
5qi	integer	9	Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI.
allocationAndRetentionPriorityLevel	integer	9	Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.
guaranteedBitRate	Ambr		Gwarantowana szybkość bitów (GBR) dla wszystkich przepływów danych usługi korzystających z tej reguły zasad przepływu danych. To jest ustawienie opcjonalne. Jeśli nie podasz wartości, dla reguły zasad przepływu danych nie będzie ustawiony gbR, która używa tej definicji QoS.
maximumBitRate	Ambr		Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych.
preemptionCapability	PreemptionCapability	NotPreempt	Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Luka w zabezpieczeniach wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.

PreemptionCapability

Możliwość wywłaszczania.

Nazwa	Typ	Opis
MayPreempt	string	Może wywłaszczać
NotPreempt	string	Nie można wywłaszczyć

PreemptionVulnerability

Luka w zabezpieczeniach dotycząca wywłaszczania.

Nazwa	Typ	Opis
NotPreemptable	string	Nie można wywłaszać
Preemptable	string	Może zostać wywłaszczone

ProvisioningState

Bieżący stan aprowizacji.

Nazwa	Typ	Opis
Accepted	string
Canceled	string
Deleted	string
Deleting	string
Failed	string
Succeeded	string
Unknown	string

QosPolicy

Zasady QoS

Nazwa	Typ	Domyślna wartość	Opis
5qi	integer	9	Wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości 5QI.
allocationAndRetentionPriorityLevel	integer	9	Poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.
maximumBitRate	Ambr		Maksymalna szybkość bitów (MBR) dla wszystkich przepływów danych usługi korzystających z tej reguły lub usługi zasad przepływu danych.
preemptionCapability	PreemptionCapability	NotPreempt	Możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Luka w zabezpieczeniach wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.

SdfDirection

Kierunek przepływu danych usługi.

Nazwa	Typ	Opis
Bidirectional	string	Ruch przepływający zarówno do, jak i z ue.
Downlink	string	Ruch przepływający z sieci danych do UE.
Uplink	string	Ruch przepływujący z ue do sieci danych.

Service

Zasób usługi. Należy utworzyć w tej samej lokalizacji co nadrzędna sieć mobilna.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.pccRules	PccRuleConfiguration[]	Zestaw reguł zasad przepływu danych, które tworzą tę usługę.
properties.provisioningState	ProvisioningState	Stan aprowizacji zasobu usługi.
properties.servicePrecedence	integer	Wartość pierwszeństwa używana do określania między usługami podczas identyfikowania wartości QoS do użycia dla określonej karty SIM. Niższa wartość oznacza wyższy priorytet. Ta wartość powinna być unikatowa wśród wszystkich usług skonfigurowanych w sieci komórkowej.
properties.serviceQosPolicy	QosPolicy	Zasady QoS do użycia dla pakietów pasujących do tej usługi. Można to przesłonić dla określonych przepływów przy użyciu pola ruleQosPolicy w pccRuleConfiguration. Jeśli to pole ma wartość null, zasady SIM ue zdefiniują ustawienia QoS.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Szablon przepływu danych

Nazwa	Typ	Opis
direction	SdfDirection	Kierunek tego przepływu.
ports	string[]	Porty, z którymi będą łączyć się interfejsy użytkownika dla tego przepływu. Można określić zero lub więcej portów lub zakresów portów. Jeśli określisz co najmniej jeden port lub zakres portów, musisz określić wartość inną niż ip w protocol polu. To jest ustawienie opcjonalne. Jeśli nie określisz tego parametru, połączenia będą dozwolone na wszystkich portach. Zakresy portów muszą być określone jako -. Na przykład: [8080, 8082-8085].
protocol	string[]	Lista dozwolonych protokołów dla tego przepływu. Jeśli chcesz, aby ten przepływ mógł używać dowolnego protokołu w pakiecie protokołów internetowych, użyj wartości ip. Jeśli chcesz zezwolić tylko na wybór protokołów, musisz użyć odpowiedniego numeru protokołu internetowego przypisanego przez IANA dla każdego protokołu, zgodnie z opisem w temacie https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Na przykład w przypadku protokołu UDP należy użyć wartości 17. Jeśli używasz wartości ip , musisz pozostawić pole port nieokreślone.
remoteIpList	string[]	Zdalny adres IP, z którym będą nawiązywane połączenia z interfejsami użytkownika dla tego przepływu. Jeśli chcesz zezwolić na połączenia na dowolnym adresie IP, użyj wartości any. W przeciwnym razie należy podać każdy z zdalnych adresów IP, z którymi będzie nawiązywać połączenie z wystąpieniem rdzeni pakietów dla tego przepływu. Należy podać każdy adres IP w notacji CIDR, w tym maskę sieci (na przykład 192.0.2.54/24).
templateName	string	Nazwa szablonu przepływu danych. Musi to być unikatowe w ramach nadrzędnej reguły zasad przepływu danych. Nie można używać żadnego z następujących zastrzeżonych ciągów — default, requested lub service.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TrafficControlPermission

Uprawnienia do sterowania ruchem.

Nazwa	Typ	Opis
Blocked	string	Ruch zgodny z tą regułą nie może przepływać.
Enabled	string	Ruch zgodny z tą regułą może przepływać.