Sims - Create Or Update

Crea o actualiza una SIM.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/simGroups/{simGroupName}/sims/{simName}?api-version=2022-04-01-preview

Parámetros de identificador URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

simGroupName
path True
  • string

Nombre del grupo sim.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

simName
path True
  • string

Nombre de la SIM.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True
  • string

Identificador de la suscripción de destino.

api-version
query True
  • string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Name Required Type Description
properties.internationalMobileSubscriberIdentity True
  • string

La identidad de suscriptor móvil internacional (IMSI) para la SIM.

properties.authenticationKey
  • string

Valor ki para la SIM.

properties.deviceType
  • string

Campo de texto de forma libre opcional que se puede usar para grabar el tipo de dispositivo al que está asociada esta SIM, por ejemplo, "Cámara de vídeo". El Azure Portal permite agrupar y filtrar SIM en función de este valor.

properties.integratedCircuitCardIdentifier
  • string

Identificador de tarjeta de circuito integrado (ICCID) para la SIM.

properties.operatorKeyCode
  • string

Valor de Opc para la SIM.

properties.simPolicy

La directiva sim usada por esta SIM.

properties.staticIpConfiguration

Lista de direcciones IP estáticas asignadas a esta SIM. Cada dirección se asigna en un ámbito de red definido, formado por {red de datos adjunta, segmento}.

systemData.createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

systemData.createdBy
  • string

Identidad que creó el recurso.

systemData.createdByType

Tipo de identidad que creó el recurso.

systemData.lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

systemData.lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

systemData.lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.

Respuestas

Name Type Description
200 OK

La actualización se realizó correctamente. La operación devuelve el recurso SIM resultante.

201 Created

Cree correctamente. La operación devuelve el recurso SIM resultante.

Other Status Codes

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Create SIM

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2022-04-01-preview

{
  "properties": {
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "authenticationKey": "00000000000000000000000000000000",
    "operatorKeyCode": "00000000000000000000000000000000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Sample Response

{
  "name": "testSim",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
{
  "name": "testSim",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim",
  "type": "Microsoft.MobileNetwork/simGroups/sims",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "simState": "Enabled",
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Definiciones

AttachedDataNetworkResourceId

Referencia a un recurso de red de datos conectado.

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

ProvisioningState

Estado de aprovisionamiento actual.

Sim

Recurso SIM.

SimPolicyResourceId

Referencia a un recurso de directiva sim.

SimState

Estado del recurso SIM.

SimStaticIpProperties

Configuración de IP estática para una SIM, cuyo ámbito es una red de datos y un segmento de datos conectados concretos.

SliceResourceId

Referencia a un recurso de segmento.

StaticIp

Configuración de IP estática para la SIM que se va a usar en el ámbito de red definido.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AttachedDataNetworkResourceId

Referencia a un recurso de red de datos conectado.

Name Type Description
id
  • string

Identificador de recurso de red de datos adjunto.

createdByType

Tipo de identidad que creó el recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

ErrorAdditionalInfo

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

Name Type Description
info
  • object

La información adicional.

type
  • string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Name Type Description
additionalInfo

Información adicional del error.

code
  • string

Código de error.

details

Los detalles del error.

message
  • string

El mensaje de error.

target
  • string

Destino del error.

ErrorResponse

Respuesta de error

Name Type Description
error

Objeto de error.

ProvisioningState

Estado de aprovisionamiento actual.

Name Type Description
Accepted
  • string
Canceled
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string

Sim

Recurso SIM.

Name Type Description
id
  • string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nombre del recurso.

properties.authenticationKey
  • string

Valor ki para la SIM.

properties.deviceType
  • string

Campo de texto de forma libre opcional que se puede usar para grabar el tipo de dispositivo al que está asociada esta SIM, por ejemplo, "Cámara de vídeo". El Azure Portal permite agrupar y filtrar SIM en función de este valor.

properties.integratedCircuitCardIdentifier
  • string

Identificador de tarjeta de circuito integrado (ICCID) para la SIM.

properties.internationalMobileSubscriberIdentity
  • string

La identidad de suscriptor móvil internacional (IMSI) para la SIM.

properties.operatorKeyCode
  • string

Valor de Opc para la SIM.

properties.provisioningState

Estado de aprovisionamiento del recurso SIM.

properties.simPolicy

La directiva sim usada por esta SIM.

properties.simState

Estado del recurso SIM.

properties.staticIpConfiguration

Lista de direcciones IP estáticas asignadas a esta SIM. Cada dirección se asigna en un ámbito de red definido, formado por {red de datos adjunta, segmento}.

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

systemData.createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

systemData.createdBy
  • string

Identidad que creó el recurso.

systemData.createdByType

Tipo de identidad que creó el recurso.

systemData.lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

systemData.lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

systemData.lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Referencia a un recurso de directiva sim.

Name Type Description
id
  • string

Id. de recurso de directiva sim.

SimState

Estado del recurso SIM.

Name Type Description
Disabled
  • string

La SIM está deshabilitada porque no hay toda la configuración necesaria para habilitarla.

Enabled
  • string

La SIM está habilitada.

Invalid
  • string

No se puede habilitar la SIM porque parte de la configuración asociada no es válida.

SimStaticIpProperties

Configuración de IP estática para una SIM, cuyo ámbito es una red de datos y un segmento de datos conectados concretos.

Name Type Description
attachedDataNetwork

Red de datos adjunta en la que se usará la dirección IP estática. La combinación de la red de datos conectada y el segmento define el ámbito de red de la dirección IP.

slice

Segmento de red en el que se usará la dirección IP estática. La combinación de la red de datos conectada y el segmento define el ámbito de red de la dirección IP.

staticIp

Configuración de IP estática para la SIM que se va a usar en el ámbito de red definido.

SliceResourceId

Referencia a un recurso de segmento.

Name Type Description
id
  • string

Identificador de recurso de segmento.

StaticIp

Configuración de IP estática para la SIM que se va a usar en el ámbito de red definido.

Name Type Description
ipv4Address
  • string

La dirección IPv4 asignada a la SIM en este ámbito de red. Esta dirección debe estar en el userEquipmentStaticAddressPoolPrefix definido en la red de datos adjunta.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.