Sim Policies - Get

Referência

Serviço:: Mobile Network

Versão da API:: 2024-04-01

Obtém informações sobre a política do SIM especificada.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
mobileNetworkName	path	True	string	O nome da rede móvel. Padrão Regex: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
simPolicyName	path	True	string	O nome da política sim. Padrão Regex: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
subscriptionId	path	True	string uuid	O ID da subscrição de destino. O valor tem de ser um UUID.
api-version	query	True	string	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Description
200 OK	SimPolicy	Pedido com êxito. A operação devolve o recurso de política sim resultante.
Other Status Codes	ErrorResponse	Resposta de erro que descreve a razão pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Get SIM policy

Pedido de amostra

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


/**
 * Samples for SimPolicies Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/SimPolicyGet.json
     */
    /**
     * Sample code: Get SIM policy.
     * 
     * @param manager Entry point to MobileNetworkManager.
     */
    public static void getSIMPolicy(com.azure.resourcemanager.mobilenetwork.MobileNetworkManager manager) {
        manager.simPolicies().getWithResponse("rg1", "testMobileNetwork", "testPolicy",
            com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.mobilenetwork import MobileNetworkManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-mobilenetwork
# USAGE
    python sim_policy_get.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.sim_policies.get(
        resource_group_name="rg1",
        mobile_network_name="testMobileNetwork",
        sim_policy_name="testPolicy",
    )
    print(response)


# x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/SimPolicyGet.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/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/SimPolicyGet.json
func ExampleSimPoliciesClient_Get() {
	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)
	}
	res, err := clientFactory.NewSimPoliciesClient().Get(ctx, "rg1", "testMobileNetwork", "testPolicy", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.SimPolicy = armmobilenetwork.SimPolicy{
	// 	Name: to.Ptr("testPolicy"),
	// 	Type: to.Ptr("Microsoft.MobileNetwork/simPolicy"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy"),
	// 	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.SimPolicyPropertiesFormat{
	// 		DefaultSlice: &armmobilenetwork.SliceResourceID{
	// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"),
	// 		},
	// 		ProvisioningState: to.Ptr(armmobilenetwork.ProvisioningStateSucceeded),
	// 		RegistrationTimer: to.Ptr[int32](3240),
	// 		SiteProvisioningState: map[string]*armmobilenetwork.SiteProvisioningState{
	// 			"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": to.Ptr(armmobilenetwork.SiteProvisioningStateAdding),
	// 			"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": to.Ptr(armmobilenetwork.SiteProvisioningStateAdding),
	// 		},
	// 		SliceConfigurations: []*armmobilenetwork.SliceConfiguration{
	// 			{
	// 				DataNetworkConfigurations: []*armmobilenetwork.DataNetworkConfiguration{
	// 					{
	// 						FiveQi: to.Ptr[int32](9),
	// 						AdditionalAllowedSessionTypes: []*armmobilenetwork.PduSessionType{
	// 						},
	// 						AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
	// 						AllowedServices: []*armmobilenetwork.ServiceResourceID{
	// 							{
	// 								ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"),
	// 						}},
	// 						DataNetwork: &armmobilenetwork.DataNetworkResourceID{
	// 							ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"),
	// 						},
	// 						DefaultSessionType: to.Ptr(armmobilenetwork.PduSessionTypeIPv4),
	// 						MaximumNumberOfBufferedPackets: to.Ptr[int32](200),
	// 						PreemptionCapability: to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
	// 						PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
	// 						SessionAmbr: &armmobilenetwork.Ambr{
	// 							Downlink: to.Ptr("1 Gbps"),
	// 							Uplink: to.Ptr("500 Mbps"),
	// 						},
	// 				}},
	// 				DefaultDataNetwork: &armmobilenetwork.DataNetworkResourceID{
	// 					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"),
	// 				},
	// 				Slice: &armmobilenetwork.SliceResourceID{
	// 					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"),
	// 				},
	// 		}},
	// 		UeAmbr: &armmobilenetwork.Ambr{
	// 			Downlink: to.Ptr("1 Gbps"),
	// 			Uplink: to.Ptr("500 Mbps"),
	// 		},
	// 	},
	// }
}

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 Gets information about the specified SIM policy.
 *
 * @summary Gets information about the specified SIM policy.
 * x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/SimPolicyGet.json
 */
async function getSimPolicy() {
  const subscriptionId =
    process.env["MOBILENETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MOBILENETWORK_RESOURCE_GROUP"] || "rg1";
  const mobileNetworkName = "testMobileNetwork";
  const simPolicyName = "testPolicy";
  const credential = new DefaultAzureCredential();
  const client = new MobileNetworkManagementClient(credential, subscriptionId);
  const result = await client.simPolicies.get(resourceGroupName, mobileNetworkName, simPolicyName);
  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

Resposta da amostra

Código de estado:: 200

{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy",
  "type": "Microsoft.MobileNetwork/simPolicy",
  "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": "Accepted",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
    },
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
            },
            "sessionAmbr": {
              "uplink": "500 Mbps",
              "downlink": "1 Gbps"
            },
            "5qi": 9,
            "allocationAndRetentionPriorityLevel": 9,
            "preemptionCapability": "NotPreempt",
            "preemptionVulnerability": "Preemptable",
            "defaultSessionType": "IPv4",
            "additionalAllowedSessionTypes": [],
            "allowedServices": [
              {
                "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ],
            "maximumNumberOfBufferedPackets": 200
          }
        ]
      }
    ]
  }
}

Definições

Name	Description
Ambr	Taxa máxima de bits agregada.
createdByType	O tipo de identidade que criou o recurso.
DataNetworkConfiguration	Definições que controlam a utilização da rede de dados
DataNetworkResourceId	Referência a um recurso de rede de dados.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
PduSessionType	Tipo de sessão PDU (IPv4/IPv6).
PreemptionCapability	Capacidade de preempção.
PreemptionVulnerability	Vulnerabilidade de preempção.
ProvisioningState	O estado de aprovisionamento atual.
ServiceResourceId	Referência a um recurso de serviço.
SimPolicy	Recurso de política sim.
SliceConfiguration	Definições por setor
SliceResourceId	Referência a um recurso de setor.
systemData	Metadados relativos à criação e última modificação do recurso.

Ambr

Taxa máxima de bits agregada.

Name	Tipo	Description
downlink	string	Taxa de bits de downlink.
uplink	string	Taxa de bits de uplink.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DataNetworkConfiguration

Definições que controlam a utilização da rede de dados

Name	Tipo	Default value	Description
5qi	integer	9	Valor do Indicador de Fluxo QoS de 5G predefinido. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Veja 3GPP TS23.501 secção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição dos valores 5QI.
additionalAllowedSessionTypes	PduSessionType[]		Tipos de sessão permitidos para além do tipo de sessão predefinido. Não é necessário duplicar o tipo de sessão predefinido.
allocationAndRetentionPriorityLevel	integer	9	Nível predefinido de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com maior prioridade preempõem fluxos com prioridade inferior, se as definições de `preemptionCapability` e `preemptionVulnerability` permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, `5qi` será utilizado para derivar o valor ARP. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
allowedServices	ServiceResourceId[]		Lista de serviços que podem ser utilizados como parte desta política sim. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item. Os serviços têm de estar na mesma localização que a política do SIM.
dataNetwork	DataNetworkResourceId		Uma referência à rede de dados à qual estas definições se aplicam. A rede de dados tem de estar na mesma localização que a política do SIM.
defaultSessionType	PduSessionType	IPv4	O tipo de sessão PDU predefinido, que é utilizado se a UE não pedir um tipo de sessão específico.
maximumNumberOfBufferedPackets	integer	10	O número máximo de pacotes de downlink a colocar em memória intermédia no plano de utilizador para Comunicação de Alta Latência – Memória Intermédia Expandida. Consulte a secção 3GPP TS29.272 v15.10.0 7.3.188 para obter uma descrição completa. Este máximo não é garantido porque existe um limite interno em pacotes em memória intermédia em todas as sessões de PDU.
preemptionCapability	PreemptionCapability	NotPreempt	Capacidade predefinida de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade inferior. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
preemptionVulnerability	PreemptionVulnerability	Preemptable	Vulnerabilidade predefinida de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP.
sessionAmbr	Ambr		Agregar a taxa máxima de bits em todos os fluxos QoS não GBR de uma determinada sessão PDU. Consulte a secção 3GPP TS23.501 5.7.2.6 para obter uma descrição completa do Session-AMBR.

DataNetworkResourceId

Referência a um recurso de rede de dados.

Name	Tipo	Description
id	string	ID do recurso de rede de dados.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

PduSessionType

Tipo de sessão PDU (IPv4/IPv6).

Name	Tipo	Description
IPv4	string
IPv6	string

PreemptionCapability

Capacidade de preempção.

Name	Tipo	Description
MayPreempt	string	May preempt
NotPreempt	string	Não é possível preemptar

PreemptionVulnerability

Vulnerabilidade de preempção.

Name	Tipo	Description
NotPreemptable	string	Não é possível preemptar
Preemptable	string	Pode ser preempida

ProvisioningState

O estado de aprovisionamento atual.

Name	Tipo	Description
Accepted	string
Canceled	string
Deleted	string
Deleting	string
Failed	string
Succeeded	string
Unknown	string

ServiceResourceId

Referência a um recurso de serviço.

Name	Tipo	Description
id	string	ID do recurso de serviço.

SimPolicy

Recurso de política sim.

Name	Tipo	Default value	Description
id	string		ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		A localização geográfica onde o recurso se encontra
name	string		O nome do recurso
properties.defaultSlice	SliceResourceId		O setor predefinido a utilizar se a UE não o especificar explicitamente. Este setor tem de existir no `sliceConfigurations` mapa. O setor tem de estar na mesma localização que a política do SIM.
properties.provisioningState	ProvisioningState		O estado de aprovisionamento do recurso de política do SIM.
properties.registrationTimer	integer	3240	Temporizador de atualização de registo periódico da UE (5G) ou temporizador de atualização da área de controlo periódico da UE (4G), em segundos.
properties.rfspIndex	integer		Índice de Prioridade de Seleção RAT/Frequência, definido em TS 36.413 3GPP. Esta é uma definição opcional e, por predefinição, não é especificada.
properties.siteProvisioningState	object		Um dicionário de sites para o estado de aprovisionamento desta política sim nesse site.
properties.sliceConfigurations	SliceConfiguration[]		Os setores permitidos e as definições a utilizar para os mesmos. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item.
properties.ueAmbr	Ambr		Agregar a taxa máxima de bits em todos os fluxos QoS não GBR de todas as sessões de PDU de uma determinada UE. Consulte a secção 3GPP TS23.501 5.7.2.6 para obter uma descrição completa do UE-AMBR.
systemData	systemData		O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.
tags	object		Etiquetas de recursos.
type	string		O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

SliceConfiguration

Definições por setor

Name	Tipo	Description
dataNetworkConfigurations	DataNetworkConfiguration[]	As redes de dados permitidas e as definições a utilizar para as mesmas. A lista não pode conter itens duplicados e tem de conter, pelo menos, um item.
defaultDataNetwork	DataNetworkResourceId	A rede de dados predefinida a utilizar se a UE não a especificar explicitamente. A configuração deste objeto tem de existir no `dataNetworkConfigurations` mapa. A rede de dados tem de estar na mesma localização que a política do SIM.
slice	SliceResourceId	Uma referência ao setor a que estas definições se aplicam. O setor tem de estar na mesma localização que a política do SIM.

SliceResourceId

Referência a um recurso de setor.

Name	Tipo	Description
id	string	Segmentar O ID do recurso.

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via

Sim Policies - Get

Parâmetros do URI

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Get SIM policy

Pedido de amostra

Resposta da amostra

Definições

Ambr

createdByType

DataNetworkConfiguration

DataNetworkResourceId

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PduSessionType

PreemptionCapability

PreemptionVulnerability

ProvisioningState

ServiceResourceId

SimPolicy

SliceConfiguration

SliceResourceId

systemData

Recursos adicionais