Freigeben über


Sims - Create Or Update

Erstellt oder aktualisiert eine SIM-Karte.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

simGroupName
path True

string

Der Name der SIM-Gruppe.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

simName
path True

string

Der Name der SIM.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.internationalMobileSubscriberIdentity True

string

Die internationale mobile Abonnentenidentität (IMSI) für die SIM.

properties.authenticationKey

string

Der Ki-Wert für die SIM.

properties.deviceType

string

Ein optionales Freiform-Textfeld, das zum Aufzeichnen des Gerätetyps verwendet werden kann, dem diese SIM zugeordnet ist, z. B. "Videokamera". Die Azure-Portal ermöglicht das Gruppieren und Filtern von SIMs basierend auf diesem Wert.

properties.integratedCircuitCardIdentifier

string

Die integrierte Schaltung Karte ID (ICCID) für die SIM.

properties.operatorKeyCode

string

Der Opc-Wert für die SIM.

properties.simPolicy

SimPolicyResourceId

Die sim-Richtlinie, die von dieser SIM-Karte verwendet wird. Die SIM-Richtlinie muss sich am gleichen Ort wie die SIM-Karte befinden.

properties.staticIpConfiguration

SimStaticIpProperties[]

Eine Liste der statischen IP-Adressen, die dieser SIM zugewiesen sind. Jede Adresse wird in einem definierten Netzwerkbereich zugewiesen, der aus {angefügtem Datennetzwerk, Slice} besteht.

Antworten

Name Typ Beschreibung
200 OK

Sim

Aktualisierung erfolgreich. Der Vorgang gibt die resultierende SIM-Ressource zurück.

201 Created

Sim

Create erfolgreich. Der Vorgang gibt die resultierende SIM-Ressource zurück.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Create SIM

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/simGroups/testSimGroup/sims/testSim?api-version=2024-04-01

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

Beispiel für eine Antwort

{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "testSim",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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": "Created",
    "simState": "Enabled",
    "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"
    },
    "integratedCircuitCardIdentifier": "8900000000000000000",
    "internationalMobileSubscriberIdentity": "00000",
    "deviceType": "Video camera",
    "simPolicy": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/MySimPolicy"
    },
    "staticIpConfiguration": [
      {
        "attachedDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP/packetCoreDataPlanes/TestPacketCoreDP/attachedDataNetworks/TestAttachedDataNetwork"
        },
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "staticIp": {
          "ipv4Address": "2.4.0.1"
        }
      }
    ]
  }
}

Definitionen

Name Beschreibung
AttachedDataNetworkResourceId

Verweis auf eine angefügte Datennetzwerkressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Sim

SIM-Ressource.

SimPolicyResourceId

Verweis auf eine SIM-Richtlinienressource.

SimState

Der Zustand der SIM-Ressource.

SimStaticIpProperties

Statische IP-Konfiguration für eine SIM-Karte, die auf ein bestimmtes angefügtes Datennetzwerk und slice ausgerichtet ist.

SliceResourceId

Verweis auf eine Sliceressource.

StaticIp

Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

AttachedDataNetworkResourceId

Verweis auf eine angefügte Datennetzwerkressource.

Name Typ Beschreibung
id

string

Id der angefügten Datennetzwerkressource.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Name Typ Beschreibung
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Sim

SIM-Ressource.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Der Name der Ressource

properties.authenticationKey

string

Der Ki-Wert für die SIM.

properties.deviceType

string

Ein optionales Freiform-Textfeld, das zum Aufzeichnen des Gerätetyps verwendet werden kann, dem diese SIM zugeordnet ist, z. B. "Videokamera". Die Azure-Portal ermöglicht das Gruppieren und Filtern von SIMs basierend auf diesem Wert.

properties.integratedCircuitCardIdentifier

string

Die integrierte Schaltung Karte ID (ICCID) für die SIM.

properties.internationalMobileSubscriberIdentity

string

Die internationale mobile Abonnentenidentität (IMSI) für die SIM.

properties.operatorKeyCode

string

Der Opc-Wert für die SIM.

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der SIM-Ressource.

properties.simPolicy

SimPolicyResourceId

Die sim-Richtlinie, die von dieser SIM-Karte verwendet wird. Die SIM-Richtlinie muss sich am gleichen Ort wie die SIM-Karte befinden.

properties.simState

SimState

Der Zustand der SIM-Ressource.

properties.siteProvisioningState

object

Ein Wörterbuch von Websites zum Bereitstellungsstatus dieser SIM-Karte auf dieser Website.

properties.staticIpConfiguration

SimStaticIpProperties[]

Eine Liste der statischen IP-Adressen, die dieser SIM zugewiesen sind. Jede Adresse wird in einem definierten Netzwerkbereich zugewiesen, der aus {angefügtem Datennetzwerk, Slice} besteht.

properties.vendorKeyFingerprint

string

Die öffentliche Schlüsselfingerabdruck des SIM-Anbieters, der diese SIM bereitgestellt hat, falls vorhanden.

properties.vendorName

string

Der Name des SIM-Anbieters, der diese SIM bereitgestellt hat, falls vorhanden.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

SimPolicyResourceId

Verweis auf eine SIM-Richtlinienressource.

Name Typ Beschreibung
id

string

RESSOURCEN-ID der SIM-Richtlinie.

SimState

Der Zustand der SIM-Ressource.

Name Typ Beschreibung
Disabled

string

Die SIM-Karte ist deaktiviert, da nicht alle für die Aktivierung erforderlichen Konfigurationen vorhanden sind.

Enabled

string

Die SIM-Karte ist aktiviert.

Invalid

string

Die SIM-Karte kann nicht aktiviert werden, weil einige der zugeordneten Konfigurationen ungültig sind.

SimStaticIpProperties

Statische IP-Konfiguration für eine SIM-Karte, die auf ein bestimmtes angefügtes Datennetzwerk und slice ausgerichtet ist.

Name Typ Beschreibung
attachedDataNetwork

AttachedDataNetworkResourceId

Das angefügte Datennetzwerk, in dem die statische IP-Adresse verwendet wird. Die Kombination aus angefügtem Datennetzwerk und Slice definiert den Netzwerkbereich der IP-Adresse. Das angefügte Datennetzwerk muss sich am selben Ort wie die SIM-Karte befinden.

slice

SliceResourceId

Der Netzwerkslice, in dem die statische IP-Adresse verwendet wird. Die Kombination aus angefügtem Datennetzwerk und Slice definiert den Netzwerkbereich der IP-Adresse. Der Slice muss sich am gleichen Speicherort wie die SIM-Karte befinden.

staticIp

StaticIp

Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll.

SliceResourceId

Verweis auf eine Sliceressource.

Name Typ Beschreibung
id

string

Slice-Ressourcen-ID.

StaticIp

Die statische IP-Konfiguration für die SIM-Karte, die im definierten Netzwerkbereich verwendet werden soll.

Name Typ Beschreibung
ipv4Address

string

Die IPv4-Adresse, die der SIM in diesem Netzwerkbereich zugewiesen ist. Diese Adresse muss sich im im angefügten Datennetzwerk definierten userEquipmentStaticAddressPoolPrefix befinden.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.